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

From: Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
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-16 11:12:10
Message-ID: cc542e25-ceef-dec1-10e0-517832aea252@enterprisedb.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-hackers

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

In response to

Responses

Browse pgsql-committers by date

  From Date Subject
Next Message Robert Haas 2023-01-16 15:26:18 Re: pgsql: Add new GUC createrole_self_grant.
Previous Message Peter Eisentraut 2023-01-16 10:15:55 pgsql: Add BufFileRead variants with short read and EOF detection

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Eisentraut 2023-01-16 11:18:08 Re: Allow tailoring of ICU locales with custom rules
Previous Message Hayato Kuroda (Fujitsu) 2023-01-16 11:09:24 RE: Exit walsender before confirming remote flush in logical replication