Re: pgsql: Doc: add XML ID attributes to <sectN> and <varlistentry> tags.

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com>
Cc: Brar Piening <brar(at)gmx(dot)de>, pgsql-hackers(at)lists(dot)postgresql(dot)org
Subject: Re: pgsql: Doc: add XML ID attributes to <sectN> and <varlistentry> tags.
Date: 2023-01-17 22:13:58
Message-ID: 3380239.1673993638@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-hackers

Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com> writes:
> 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

OK, done like that.

regards, tom lane

In response to

Browse pgsql-committers by date

  From Date Subject
Next Message Michael Paquier 2023-01-18 00:05:28 pgsql: Constify the arguments of copydir.h functions
Previous Message Tom Lane 2023-01-17 22:13:27 pgsql: Doc: fix a few oddly-spelled SGML ID attributes.

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Geoghegan 2023-01-17 22:18:20 Re: Rework of collation code, extensibility
Previous Message Robert Haas 2023-01-17 22:11:07 Re: Decoupling antiwraparound autovacuum from special rules around auto cancellation