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

Marcos Pegoraro <marcos@f10.com.br>

From: Marcos Pegoraro <marcos@f10.com.br>
To: Peter Eisentraut <peter@eisentraut.org>
Cc: Laurenz Albe <laurenz.albe@cybertec.at>, PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2025-12-31T18:18:41Z
Lists: pgsql-hackers

Attachments

Em dom., 28 de dez. de 2025 às 10:59, Peter Eisentraut <peter@eisentraut.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