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

From: Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>
To: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
Cc: Peter Eisentraut <peter(at)eisentraut(dot)org>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Get rid of "Section.N.N.N" on DOCs
Date: 2025-12-27 13:55:44
Message-ID: CAB-JLwatnpK9yNzWbp_a6s9-MUQtQn3iqSRqci859PJh4_qYFA@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Em sáb., 27 de dez. de 2025 às 09:16, Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
escreveu:

> That makes sense to me.
>
Fine.

And what about those xreflabel that already exists, what do we do with them
?
<refsec and <varlistentry are fine but <sec is not done or done poorly.
If you search without my patch with this regex you'll get only 58
occurrences.
(^\s*<sect\d\sid)(="(?=\S*)([a-zA-Z0-9_-]+))(" xreflabel=)(".+?")(>)
and see $3 and $5 parts of regex you'll get something very similar between
id and xreflabel.
27 of them are the same and the others are just small replacements. None
capitalized, none as separate words.
id="auth-delay" reflabel="auth_delay"
id="basic-archive" reflabel="basic_archive"
and so on

Only two of them are replaced carefully
id="standby-server-operation" reflabel="Standby Server Operation"
id="jit-configuration" reflabel="JIT Configuration"

I think these places need to be replaced carefully too.

You'll get more or less 600 occurrences on config, libpq, select,
create_table and monitoring.sgml but there are always params of these
specific places, so it's not a problem to reflabel be the same as its
config name.

regards
Marcos

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Tomas Vondra 2025-12-27 14:52:21 Re: Add the ability to limit the amount of memory that can be allocated to backends.
Previous Message Tomas Vondra 2025-12-27 13:18:56 Re: Limit memory usage by postgres_fdw batches