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: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Get rid of "Section.N.N.N" on DOCs
Date: 2025-12-31 18:18:41
Message-ID: CAB-JLwaX+SwjoDnu74ZCDYnAcrF7i_anvqK=XJSg7uyDrE+jEw@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Em dom., 28 de dez. de 2025 às 10:59, Peter Eisentraut <peter(at)eisentraut(dot)org>
escreveu:

> Independent of what link text style you prefer, manually maintaining
> xreflabel attributes is the wrong solution. The XSL stylesheets
> automatically compute the link title from the section number or title,
> and there are parameters to choose between different styles. If you
> don't like the styles offered by the parameters, the fix will be to
> override the XSL code that computes the link text.
>

As you pointed out, I discovered how to customize those items on XSL and
it's done for all.
As you can see in the image, the differences between old and new are huge.
And as you can see on image, it does not make sense to have PL/pgSQL,
PL/Perl, etc duplicated.

This is just an example of how to do it, so it's not covered for all other
items like example, item, refsect and so on.
Appendix is written differently too as a test. But then it is just a
decision if we want and how we want each of them.

And if we want then is to start the harder part, read and modify every item
that is not properly written.

[image: image.png]
regards
Marcos

Attachment Content-Type Size
V2-0001 Get rid Section n.n.n.n from DOCs.diff application/octet-stream 1.9 KB

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2025-12-31 18:37:21 Re: Add "format" target to make and ninja to run pgindent and pgperltidy
Previous Message Jelte Fennema-Nio 2025-12-31 18:17:39 Re: Add "format" target to make and ninja to run pgindent and pgperltidy