On Fri, 10 Aug 2001, Jeff Walker spake:
> I also, absolutely hate the Linux documentation is moving; that is, having a
> man page that is a summary (at best) or not even there or out of date, and
> having the real doc in "info" format. I hate that. On Unix, I expect the
> man pages to at least have a proper command-line usage, if not the entire
> documentation.
I think you are talking about GNU projects when you say `Linux
documentation'. The GNU Project has long had the policy of maintaining
primary documentation in texinfo format, because that is convertible to
more output formats than troff, and is more expressive. Sometimes, man
pages for some projects were separately maintained, but they always got
out of date.
However, recently the GNU help2man program was released to convert the
invocation sections of info pages to man pages, and new releases of GNU
projects are tending to use this to generate up-to-date man pages at
last.
(Also, I don't think it's info pages you dislike; it's the standalone
info *reader*, which is horrible. There are much better combined
man/info readers out there, like tkman; find one you like and use it,
and you'll soon ignore the source of your documentation --- except that
info pages are often better written and less terse than man pages ;) )
--
`It's all about bossing computers around. Users have to say "please".
Programmers get to say "do what I want NOW or the hard disk gets it".'
-- Richard Heathfield on the nature of programming
--
Visit the official FVWM web page at <URL: http://www.fvwm.org/>.
To unsubscribe from the list, send "unsubscribe fvwm" in the body of a
message to majordomo_at_fvwm.org.
To report problems, send mail to fvwm-owner_at_fvwm.org.
Received on Sat Aug 11 2001 - 18:30:09 BST