Date: Tue, 8 Aug 2000 19:18:02 +0100 From: Nik Clayton <nik@freebsd.org> To: Ben Smithurst <ben@FreeBSD.org> Cc: Jim Mock <jim@jmock.com>, freebsd-doc@FreeBSD.org Subject: Re: No index in The FreeBSD Handbook? Message-ID: <20000808191802.A99380@catkin.nothing-going-on.org> In-Reply-To: <20000808105115.Q65753@strontium.scientia.demon.co.uk>; from ben@FreeBSD.org on Tue, Aug 08, 2000 at 10:51:15AM %2B0100 References: <4.3.2.7.2.20000807173830.00b0adc0@mail.utexas.edu> <20000807181715.D34835@luna.osd.bsdi.com> <20000808105115.Q65753@strontium.scientia.demon.co.uk>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000808191802.A99380>