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

From: Peter Eisentraut <peter(at)eisentraut(dot)org>
To: Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>, Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
Cc: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Get rid of "Section.N.N.N" on DOCs
Date: 2025-12-28 13:59:47
Message-ID: 894487e4-29b8-4a9d-a908-68a3a09f7692@eisentraut.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 23.12.25 15:39, Marcos Pegoraro wrote:
> There are a few more files that my regular expression couldn't find
> initially, now I think they've all been affected.
>
> Even many that don't have any links pointing to them also have the tag,
> so that when someone links to them, they automatically display the Title
> and not the section number.
>
> If everything is okay, we can start rewriting all places that sounds
> strange in the HTML file.
> But this is a much slower process, as it requires reading all the
> affected pages.

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.

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Henson Choi 2025-12-28 14:19:02 Re: RFC: PostgreSQL Storage I/O Transformation Hooks
Previous Message Peter Eisentraut 2025-12-28 13:55:04 Re: Get rid of "Section.N.N.N" on DOCs