[TUHS] man-page style

Toby Thain toby at telegraphics.com.au
Sun Nov 18 13:00:45 AEST 2018


On 2018-11-17 7:31 PM, Donald ODona wrote:
> 
> 
> At 17 Nov 2018 23:39:45 +0000 (+00:00) from Ralph Corderoy <ralph at inputplus.co.uk>:
>>
>> From somewhere that didn't fit in well with Unix.
> its based on TekInfo, whereas 'Tek' allegedly refers to the anachronistic Tape Editor and Corrector, developed by a student (Dan Murphy) in 1964 on a PDP-1 without a operation system. According to the myth TekInfo was build on top of the Tape Editor, and finally made it on *NIX.
> 
> 'Info' really doesn't fit in well with Unix. Its alien and another failed approach. Almost all 'GNU' man pages state, that the 'full' documentation is only available via 'info'. In real 99% of all 'info' requests  result in 'info' processing a man page.


In many notable examples, that is not true: e.g. GNU make, bash or bison
come quickly to mind. You can't fully learn how to use tools like these
from the abbreviated man page; for one thing, the man page only mentions
a fraction of the features.

`info` provides a comprehensive, well written manual and tutorial for
these tools. If you haven't seen them, have a good look. Removing `info`
would leave them only partially documented and without tutorials.

--Toby


 Thus its redundant and should be removed from all *NIX systems. Even in
emacs some progressive developers recommend to replace 'info' by html or
something else modern.
> 




More information about the TUHS mailing list