Re: Get rid of "Section.N.N.N" on DOCs - Mailing list pgsql-hackers

From Isaac Morland
Subject Re: Get rid of "Section.N.N.N" on DOCs
Date
Msg-id CAMsGm5fShAG9d7vGZr9NMz2a_BFJ0-k9z1NA_3m81ryK_sBX_Q@mail.gmail.com
Whole thread Raw
In response to Re: Get rid of "Section.N.N.N" on DOCs  ("David G. Johnston" <david.g.johnston@gmail.com>)
List pgsql-hackers
On Sun, 14 Dec 2025 at 12:35, David G. Johnston <david.g.johnston@gmail.com> wrote:
On Sun, Dec 14, 2025 at 10:30 AM Marcos Pegoraro <marcos@f10.com.br> wrote:
There are places where links are mixed, some of them are auto explanatory, some don't, like on See Also of VACUUM
For that we need only put a "xreflabel" tag on that target link. 

I can create a patch for all of them, but I would like to know why it's done this way.

That would be great.  I don't think it's intentional, just not everyone knowing and thus failing to add the additional attribute.

Is there any way to do this automatically, not by editing all the references, but by changing how they're formatted? It seems to me that all links to the same section should have the same link text, which should be some combination of the section number and/or title/description. So ideally this would be a matter of changing how the link text is computed. If we rename a section, we presumably want all references to it to update accordingly. 

pgsql-hackers by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: Get rid of "Section.N.N.N" on DOCs
Next
From: Etsuro Fujita
Date:
Subject: Re: Import Statistics in postgres_fdw before resorting to sampling.