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

From Marcos Pegoraro
Subject Re: Get rid of "Section.N.N.N" on DOCs
Date
Msg-id CAB-JLwZqNAQf+0O+W4wS2dxJRUiN+i=mLXz=63SNFq-U+L=ufQ@mail.gmail.com
Whole thread
In response to Re: Get rid of "Section.N.N.N" on DOCs  (Peter Eisentraut <peter@eisentraut.org>)
Responses Re: Get rid of "Section.N.N.N" on DOCs
List pgsql-hackers
Em qua., 24 de jun. de 2026 às 09:49, Peter Eisentraut <peter@eisentraut.org> escreveu:
I have no idea what this patch is supposed to accomplish.

The goal of this thread was to make it easier to read the DOCs, changing how xref to Section, Chapter, Appendix and Tables are shown.
To have this done, it's not enough to just change the .XSL file so that it no longer shows the numbers but its title, it's necessary to change all places where that xref is used.

An example of how is shown today.
  For more information on parallel query, see Chapter 15.

If I only change the XSL file, it'll change to this
  For more information on parallel query, see Parallel Query.

But, as you can see, new text would become confused or duplicated, so we have to change not only the XSL file, but all places where that xref was used, and this job we did with the help of AI.
  For more information, see Parallel Query.

Douglas sent initially two files, one xref_review.HTML to visually see how that diff would become, and the patch itself.
I think the best way for you to see the result is to open xref_review.HTML.

Then now he sent just the rebase of that patch

regards
Marcos

pgsql-hackers by date:

Previous
From: Dilip Kumar
Date:
Subject: Re: Proposal: Conflict log history table for Logical Replication
Next
From: Fujii Masao
Date:
Subject: Re: psql: add tab completion for subscription wal_receiver_timeout