From owner-freebsd-doc Tue Aug 8 11:25:49 2000 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id C410C37BF40; Tue, 8 Aug 2000 11:25:37 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id TAA99543; Tue, 8 Aug 2000 19:18:02 +0100 (BST) (envelope-from nik) Date: Tue, 8 Aug 2000 19:18:02 +0100 From: Nik Clayton To: Ben Smithurst Cc: Jim Mock , freebsd-doc@FreeBSD.org Subject: Re: No index in The FreeBSD Handbook? Message-ID: <20000808191802.A99380@catkin.nothing-going-on.org> References: <4.3.2.7.2.20000807173830.00b0adc0@mail.utexas.edu> <20000807181715.D34835@luna.osd.bsdi.com> <20000808105115.Q65753@strontium.scientia.demon.co.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.4i In-Reply-To: <20000808105115.Q65753@strontium.scientia.demon.co.uk>; from ben@FreeBSD.org on Tue, Aug 08, 2000 at 10:51:15AM +0100 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Aug 08, 2000 at 10:51:15AM +0100, Ben Smithurst wrote: > > On Mon, 07 Aug 2000 at 17:40:55 -0500, Oscar Ricardo Silva wrote: > >> We ordered several copies of The FreeBSD Handbook and received them > >> today. This may be a minor thing but we noticed that there is no > >> Index at the back of the book. Is this a mistake? On purpose? > > > > The reason there's no index is because there aren't any index tags in > > the DocBook version of the handbook. This is something on the Doc > > Project's todo list -- it's not a small task, > > So, what exactly needs doing to get an index? Just add some tag around > bits which should be indexed, or is there more to it than that? There's more to it than that. I understand (although it's not something I've personally done) that there's an art to indexing. For example, there's little point in indexing every occurence of the word "port" in the Handbook, to try and direct people to information about ports. There are then some hoops to jump through to get the index included in the document. More details at http://www.nwalsh.com/docbook/dsssl/doc/indexing.html *Please*, feel free to play around with this -- it's been on my list for a while, and other stuff keeps pushing it out of the way. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message