Re: Get rid of "Section.N.N.N" on DOCs - Mailing list pgsql-hackers

From Marcos Pegoraro
Subject Re: Get rid of "Section.N.N.N" on DOCs
Date
Msg-id CAB-JLwb4zGGggHoNPmv4wgJhj6Rjex0MQup=K75Pyv2Nr=KzbA@mail.gmail.com
Whole thread Raw
In response to Re: Get rid of "Section.N.N.N" on DOCs  (Laurenz Albe <laurenz.albe@cybertec.at>)
Responses Re: Get rid of "Section.N.N.N" on DOCs
List pgsql-hackers
Em seg., 15 de dez. de 2025 às 09:19, Laurenz Albe <laurenz.albe@cybertec.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

pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: Fixing the btree_gist inet mess
Next
From: "David G. Johnston"
Date:
Subject: Re: Get rid of "Section.N.N.N" on DOCs