From: Tom Lane <tgl@sss.pgh.pa.us>
To: pgsql-docs@postgreSQL.org
Subject: Inconsistent treatment of <indexterm> entries in new docs build
Date: Thu, 29 Dec 2016 18:18:34 -0500
Message-ID: <29262.1483053514@sss.pgh.pa.us> (raw)
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
I made a change in 3c9d39848 that inserted these index entries:
<indexterm>
<primary>median</primary>
</indexterm>
<indexterm>
<primary>median</primary>
<seealso>percentile</seealso>
</indexterm>
The new docs toolchain doesn't complain about this, and it produces
the output I wanted:
median, Aggregate Expressions
(see also percentile)
However, "make oldhtml" complains:
Processing HTML.index...
2705 entries loaded...
collateindex.pl: duplicated index entry found: MEDIAN
1 entries ignored...
Done.
and it doesn't emit the "see also" entry.
So, is what I wrote valid SGML? If so, can we fix the older build
process to cope? If not, can we fix the new process to complain?
The thing that is bothering me is that I back-patched this change without
realizing that it wouldn't work in the back branches. This won't be the
last such mistake, if we can't persuade the two toolchains to accept the
same input.
regards, tom lane
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us
Subject: Re: Inconsistent treatment of <indexterm> entries in new docs build
In-Reply-To: <29262.1483053514@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox