From owner-freebsd-questions Mon Feb 24 15: 7:20 2003 Delivered-To: freebsd-questions@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B351E37B401 for ; Mon, 24 Feb 2003 15:07:18 -0800 (PST) Received: from mailsrv.otenet.gr (mailsrv.otenet.gr [195.170.0.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id AE10443F93 for ; Mon, 24 Feb 2003 15:07:14 -0800 (PST) (envelope-from keramida@ceid.upatras.gr) Received: from gothmog.gr (patr530-a013.otenet.gr [212.205.215.13]) by mailsrv.otenet.gr (8.12.6/8.12.6) with ESMTP id h1ON78AK014524; Tue, 25 Feb 2003 01:07:12 +0200 (EET) Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.7/8.12.7) with ESMTP id h1ON78RZ011782; Tue, 25 Feb 2003 01:07:08 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) Received: (from giorgos@localhost) by gothmog.gr (8.12.7/8.12.7/Submit) id h1ON72xI011773; Tue, 25 Feb 2003 01:07:02 +0200 (EET) (envelope-from keramida@ceid.upatras.gr) Date: Tue, 25 Feb 2003 01:07:02 +0200 From: Giorgos Keramidas To: Cliff Sarginson 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> 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> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030224202824.GB603@raggedclown.net> Sender: owner-freebsd-questions@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On 2003-02-24 21:28, Cliff Sarginson 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