Re: Get rid of "Section.N.N.N" on DOCs - Mailing list pgsql-hackers

From Peter Eisentraut
Subject Re: Get rid of "Section.N.N.N" on DOCs
Date
Msg-id 894487e4-29b8-4a9d-a908-68a3a09f7692@eisentraut.org
Whole thread Raw
In response to Re: Get rid of "Section.N.N.N" on DOCs  (Marcos Pegoraro <marcos@f10.com.br>)
Responses Re: Get rid of "Section.N.N.N" on DOCs
List 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.




pgsql-hackers by date:

Previous
From: Peter Eisentraut
Date:
Subject: Re: Get rid of "Section.N.N.N" on DOCs
Next
From: Henson Choi
Date:
Subject: Re: RFC: PostgreSQL Storage I/O Transformation Hooks