Re: Get rid of "Section.N.N.N" on DOCs

From: Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>
To: Peter Eisentraut <peter(at)eisentraut(dot)org>
Cc: Douglas Domingues da Silveira <douglas(at)f10(dot)com(dot)br>, Robert Treat <rob(at)xzilla(dot)net>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Get rid of "Section.N.N.N" on DOCs
Date: 2026-06-24 14:00:23
Message-ID: CAB-JLwZqNAQf+0O+W4wS2dxJRUiN+i=mLXz=63SNFq-U+L=ufQ@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Em qua., 24 de jun. de 2026 às 09:49, Peter Eisentraut <peter(at)eisentraut(dot)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

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Fujii Masao 2026-06-24 14:02:04 Re: psql: add tab completion for subscription wal_receiver_timeout
Previous Message Dilip Kumar 2026-06-24 13:56:41 Re: Proposal: Conflict log history table for Logical Replication