[Info-vax] Radical command line suggestion

[Scott Dorsey]

Help entries were in great part intended as tutorials, man pages were intended
as references.

Because of the difference in intended purpose, there are a lot of differences
in configuration and use.

Now, I will say that because Unix dialects vary so considerably, so do man
pages.  If you check out the man pages of 4.2BSD, you will find they are a
whole lot more extensive and better written than the ones on a modern Linux.
There are far more examples, and everything is documented, even drivers.

This is sort of the main problem with free-form open software development,
that everyone wants to write code but nobody wants to write documentation.

One of the issues with man, even if you have apropos on your system, is
that it's very good for explaining a command but it's pretty much useless
for explaining what command you want.  In the v7 days, there was plenty of
other documentation for that although that seems to have fallen by the 
wayside in the Linux world.

The VMS help pages are helpful, but they don't document everything.  I cannot
do 'help authorize.dat' for instance.  But then again, they aren't really for
that and there is a whole grey wall to look at if you want that information.
--scott

If you do 'man tunefs' and the first line is 'You can tune a filesystem but
you can't tuna fish' you know a little more about the people who developed
the OS...
-- 
"C'est un Nagra. C'est suisse, et tres, tres precis."