Date: Tue, 25 Feb 2003 01:07:02 +0200 From: Giorgos Keramidas <keramida@ceid.upatras.gr> To: Cliff Sarginson <cls@raggedclown.net> Cc: freebsd-questions@FreeBSD.org Subject: Re: GNU programs & texinfo docs vs. manpages [was: Re: linker paths & /usr/local/lib] Message-ID: <20030224230702.GA11576@gothmog.gr> In-Reply-To: <20030224202824.GB603@raggedclown.net> References: <20030223152808.GA1391@kalgan.vic.optushome.com.au> <20030223165133.79e9aa2b.flynn@energyhq.homeip.net> <20030224011724.GA296@kalgan.vic.optushome.com.au> <20030224080534.61fa0166.flynn@energyhq.homeip.net> <20030224073911.GA10158@kalgan.vic.optushome.com.au> <20030224194808.GC594@gothmog.gr> <20030224202824.GB603@raggedclown.net>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2003-02-24 21:28, Cliff Sarginson <cls@raggedclown.net> wrote: > On Mon, Feb 24, 2003 at 09:48:08PM +0200, Giorgos Keramidas wrote: > > GNU people do hate manpages annd avoid them some times :( > > Navigating info pages is like having teeth pulled without novocaine. Well, that's a bit of an exaggeration there, but I get your point. The whole problem with Texinfo is that it doesn't have a well defined, pretty much standard, well-known and respected layout for the presentation of information to you. The fact that you find it difficult to navigate .info documents is not a direct result of the format used to write the documentation, but a side-effect of the way things are organised in the original document. Most of the Texinfo documents I've read haven't been written to be read sequentially. Sometimes, there isn't a well-defined order of all the "nodes"; which only makes things worse. There are a few very good documents in Texinfo though. The open sourced book about CVS of http://cvsbook.red-bean.com is a very good example of a Texinfo document that I really, I mean REALLY, enjoyed reading. It's not the format. It's the writer... To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-questions" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030224230702.GA11576>