From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Brar Piening <brar@gmx.de>
Cc: pgsql-hackers@lists.postgresql.org
Subject: Re: pgsql: Doc: add XML ID attributes to <sectN> and <varlistentry> tags.
Date: Mon, 16 Jan 2023 12:12:10 +0100
Message-ID: <cc542e25-ceef-dec1-10e0-517832aea252@enterprisedb.com> (raw)
In-Reply-To: <769446.1673478332@sss.pgh.pa.us>
References: <E1pEyRa-002rhZ-B4@gemulon.postgresql.org>
<56f62f5e-86d6-70d0-2d5a-49e1480e3c0b@enterprisedb.com>
<769446.1673478332@sss.pgh.pa.us>
On 12.01.23 00:05, Tom Lane wrote:
> That reminds me that I was going to suggest fixing the few existing
> variances from the "use '-' not '_'" policy:
>
> $ grep 'id="[a-zA-Z0-9-]*_' *sgml ref/*sgml
> config.sgml: <varlistentry id="guc-plan-cache_mode" xreflabel="plan_cache_mode">
should be fixed
> libpq.sgml: <varlistentry id="libpq-PQpingParams-PQPING_OK">
> libpq.sgml: <varlistentry id="libpq-PQpingParams-PQPING_REJECT">
> libpq.sgml: <varlistentry id="libpq-PQpingParams-PQPING_NO_RESPONSE">
> libpq.sgml: <varlistentry id="libpq-PQpingParams-PQPING_NO_ATTEMPT">
I think we can leave these. They are internally consistent.
> pgbuffercache.sgml: <table id="pgbuffercache_summary-columns">
should be fixed
> ref/pg_checksums.sgml: <refsect1 id="r1-app-pg_checksums-1">
pretty bogus
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 from your mail client; the link fills in
the headers below: reply via email
Some clients, webmail especially, drop In-Reply-To and References from
a link, and the reply then starts a new thread: use the mbox below.
To: pgsql-committers@postgresql.org
Cc: peter.eisentraut@enterprisedb.com, tgl@sss.pgh.pa.us, brar@gmx.de, pgsql-hackers@lists.postgresql.org
Subject: Re: pgsql: Doc: add XML ID attributes to <sectN> and <varlistentry> tags.
In-Reply-To: <cc542e25-ceef-dec1-10e0-517832aea252@enterprisedb.com>
References: <E1pEyRa-002rhZ-B4@gemulon.postgresql.org> <56f62f5e-86d6-70d0-2d5a-49e1480e3c0b@enterprisedb.com> <769446.1673478332@sss.pgh.pa.us> <cc542e25-ceef-dec1-10e0-517832aea252@enterprisedb.com>
* 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