On Sun, 14 Dec 2025 at 12:35, David G. Johnston <[email protected]> wrote:
> On Sun, Dec 14, 2025 at 10:30 AM Marcos Pegoraro <[email protected]> > 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. > Is there any way to do this automatically, not by editing all the references, but by changing how they're formatted? It seems to me that all links to the same section should have the same link text, which should be some combination of the section number and/or title/description. So ideally this would be a matter of changing how the link text is computed. If we rename a section, we presumably want all references to it to update accordingly.
