Re: Doc: Fixup misplaced filelist.sgml entities and add some commentary - Mailing list pgsql-hackers

From David G. Johnston
Subject Re: Doc: Fixup misplaced filelist.sgml entities and add some commentary
Date
Msg-id CAKFQuwaLDQJpKrnoojSyj25B=AJY4NcyTb+CxaMrig1xrwY3VA@mail.gmail.com
Whole thread Raw
In response to Re: Doc: Fixup misplaced filelist.sgml entities and add some commentary  (Marcos Pegoraro <marcos@f10.com.br>)
List pgsql-hackers
On Wed, Mar 19, 2025 at 2:31 PM Marcos Pegoraro <marcos@f10.com.br> wrote:
Em qua., 19 de mar. de 2025 às 18:14, David G. Johnston <david.g.johnston@gmail.com> escreveu:
Having been in filelist.sgml a bit recently I've noticed that the original alphabetical ordering of the entities therein hasn't been adhered to.  Partly, I suspect, because there is no guidance about these files and how they are organized.  The attached puts things back into alphabetical order (by section) and adds some commentary to this and related files, and the manual.

Liked that.

Just one typo: chatpers should be chapters.


Thanks.

I've got some additional thoughts for the next version; though I figure this, and the others like it out there right now, won't get much attention until mid-April.

Be better to do larger refactorings like this after feature freeze anyway.  We've tended to not consider the documentation part of what is frozen so looking at it post-deadline makes sense.

David J.

pgsql-hackers by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: Make COPY format extendable: Extract COPY TO format implementations
Next
From: Noah Misch
Date:
Subject: Re: AIO v2.5