| 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 |
| 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 |