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>
Cc: Douglas Domingues da Silveira <douglas(at)f10(dot)com(dot)br>, Robert Treat <rob(at)xzilla(dot)net>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Get rid of "Section.N.N.N" on DOCs
Date: 2026-06-24 15:39:49
Message-ID: 08575f84-1a05-477f-adbc-e6bb9ee551b6@eisentraut.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 24.06.26 16:00, Marcos Pegoraro wrote:
> Em qua., 24 de jun. de 2026 às 09:49, Peter Eisentraut
> <peter(at)eisentraut(dot)org <mailto:peter(at)eisentraut(dot)org>> escreveu:
>
> I have no idea what this patch is supposed to accomplish.
>
>
> The goal of this thread was to make it easier to read the DOCs, changing
> how xref to Section, Chapter, Appendix and Tables are shown.
> To have this done, it's not enough to just change the .XSL file so that
> it no longer shows the numbers but its title, it's necessary to change
> all places where that xref is used.
>
> An example of how is shown today.
>   For more information on parallel query, see Chapter 15.
>
> If I only change the XSL file, it'll change to this
>   For more information on parallel query, see Parallel Query.

I don't know what XSL you attempted to change, but if I change

-<xsl:param name="xref.with.number.and.title" select="0"></xsl:param>
+<xsl:param name="xref.with.number.and.title" select="1"></xsl:param>

I get

For more information on parallel query, see Chapter 15, Parallel Query.

which would satisfy both those who want titles and those who want numbers.

I don't think removing the numbers would be acceptable.

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Eisentraut 2026-06-24 15:43:50 Re: glob support in extension_control_path/dynamic_library_path?
Previous Message Alexander Nestorov 2026-06-24 15:34:39 Re: [PATCH] btree_gist: add cross-type integer operator support for GiST