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: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Get rid of "Section.N.N.N" on DOCs
Date: 2025-12-19 18:56:04
Message-ID: CAB-JLwb4zGGggHoNPmv4wgJhj6Rjex0MQup=K75Pyv2Nr=KzbA@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Em seg., 15 de dez. de 2025 às 09:19, Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
escreveu:

> Apart from the effort of the change, there is also the increased effort of
> backpatching documentation changes, and those efforts have to be
> outbalanced
> by the benefits.
>

Are you sure we need to backpatch all these changes ?
I'm not talking about the job I'll have but the job the committer will have.
There are almost 300 different section numbers and more than 700 places
will be changed,
so will be 700 multiplied by how many versions of it. Are you sure ?

I changed 8 or 10 just for testing and sending two as an example, just to
see if it's worthwhile.
Environment Variables need to change source and target, 30 places.
String constants just source part, easy to change but harder to verify all
related parts.

regards
Marcos

Attachment Content-Type Size
V1-0001 Get rid of section n_n_n - Environment Variables.diff application/octet-stream 17.9 KB
V1-0001 Get rid of section n_n_n - string constants.diff application/octet-stream 842 bytes

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message David G. Johnston 2025-12-19 19:10:56 Re: Get rid of "Section.N.N.N" on DOCs
Previous Message Tom Lane 2025-12-19 18:27:57 Re: Fixing the btree_gist inet mess