From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: remove endterms and title ids
Date: Wed, 20 Dec 2017 16:00:54 -0300
Message-ID: <20171220190054.tujmp6uyzhx6o45f@alvherre.pgsql> (raw)
In-Reply-To: <4a60dfc3-061b-01c4-2b86-279d3a612fd2@2ndquadrant.com>
Peter Eisentraut wrote:
> The attached patch removes endterm attributes from xref elements and the
> associated id attributes on title elements.
>
> Older documentation toolchains could not automatically generate text for
> xrefs into refentries, so we had to use the endterm attribute to tell it
> which text to create. This is no longer necessary and can be removed.
> In most cases, we can just rely on the automatically generated text.
So we had
There are several caveats to be aware of when using this option — see
_Building Indexes Concurrently_.
and with this patch we end up with
There are several caveats to be aware of when using this option — see
_the section called “Building Indexes Concurrently”_.
which looks pretty ugly to me. I think getting rid of the
mostly-pointless id attributes is a good motivation, but I wonder if
there's a way to retain the text as originally generated.
--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
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: alvherre@alvh.no-ip.org, peter.eisentraut@2ndquadrant.com
Subject: Re: remove endterms and title ids
In-Reply-To: <20171220190054.tujmp6uyzhx6o45f@alvherre.pgsql>
* 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