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

David G. Johnston <david.g.johnston@gmail.com>

From: "David G. Johnston" <david.g.johnston@gmail.com>
To: Marcos Pegoraro <marcos@f10.com.br>
Cc: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2025-12-14T17:35:17Z
Lists: pgsql-hackers
On Sun, Dec 14, 2025 at 10:30 AM Marcos Pegoraro <marcos@f10.com.br> wrote:

> There are places where links are mixed, some of them are auto explanatory,
> some don't, like on See Also of VACUUM
> vacuumdb <https://www.postgresql.org/docs/18/app-vacuumdb.html>,
> Section 19.10.2
> <https://www.postgresql.org/docs/18/runtime-config-vacuum.html#RUNTIME-CONFIG-RESOURCE-VACUUM-COST>
> , Section 24.1.6
> <https://www.postgresql.org/docs/18/routine-vacuuming.html#AUTOVACUUM>,
> Section 27.4.5
> <https://www.postgresql.org/docs/18/progress-reporting.html#VACUUM-PROGRESS-REPORTING>
> , Section 27.4.2
> <https://www.postgresql.org/docs/18/progress-reporting.html#CLUSTER-PROGRESS-REPORTING>
>
> For that we need only put a "xreflabel" tag on that target link.
>
> I can create a patch for all of them, but I would like to know why it's
> done this way.
>

That would be great.  I don't think it's intentional, just not everyone
knowing and thus failing to add the additional attribute.

David J.