Re: [HACKERS] broken doc - Mailing list pgsql-docs

From Peter Eisentraut
Subject Re: [HACKERS] broken doc
Date
Msg-id 200708311116.41574.peter_e@gmx.net
Whole thread Raw
List pgsql-docs
Am Freitag, 31. August 2007 06:06 schrieb Tom Lane:
> I'm no expert in this, but looking at the complained-of bookindex.sgml
> entries makes me think that those index entries have a semantic conflict
> with these entries over in indices.sgml:
>
>    <indexterm>
>     <primary>GiST</primary>
>     <see>index</see>
>    </indexterm>

Yeah, apparently it is not supported to have a single term being a "see
$elsewhere" and a direct link.  The semantics of that are debatable anyway.
The index building tool just creates garbage in that case.

> Perhaps we need to have a meeting of the minds on who gets to define the
> primary index entries about GiST and GIN?

I'd say that the text search section shouldn't be the primary source on GiST
and GIN, just like the section on arithmetic operators isn't the primary
source on B-tree.  That might require moving some text around, though.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/

pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Problem with index building
Next
From: Decibel!
Date:
Subject: Code examples