public inbox for [email protected]  

help / color / mirror / Atom feed

From: Álvaro Herrera <[email protected]>
To: jian he <[email protected]>
Cc: [email protected]
Subject: Re: copy.sgml: add XML ID attributes to <varlistentry> tags.
Date: Fri, 14 Nov 2025 12:05:23 +0100
Message-ID: <[email protected]> (raw)
In-Reply-To: <CACJufxFsPXCwSVR+_vScZ3bysh4-dpE19iVyeta30uNHwnwnSw@mail.gmail.com>

On 2025-Oct-29, jian he wrote:

> hi.
> 
> similar to what we did in
> https://git.postgresql.org/cgit/postgresql.git/commit/?id=78ee60ed84bb3a1cf0b6bd9a715dcbcf252a90f5
> 
> I happened to notice COPY.sgml <refsect1> Parameters section is un-linkable.
> The Parameters section in copy.sgml has shorter explanations compared to
> create_table.sgml, but it contains a long list of options.
> 
> So I think making Each parameter linkable would improve readability.

Makes sense.  I have pushed this.  Two minor tweaks: a) I added IDs to
refsect1s as well, because we do that in the other ref pages, and it
seemed out of place to have them in parameters but not for the sections,
and b) I renamed the ones in your patch to use all-lowercase (as well as
dash instead of underscore), as well as added the "-params" marker to
create a sort of hierarchy of the IDs, the way we do in other pages.

Thanks!

-- 
Álvaro Herrera               48°01'N 7°57'E  —  https://www.EnterpriseDB.com/
"Linux transformó mi computadora, de una `máquina para hacer cosas',
en un aparato realmente entretenido, sobre el cual cada día aprendo
algo nuevo" (Jaime Salinas)

reply

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: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: copy.sgml: add XML ID attributes to <varlistentry> tags.
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox