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

From David G. Johnston
Subject Doc: Fixup misplaced filelist.sgml entities and add some commentary
Date
Msg-id CAKFQuwb05WkXYPQhdyAVk+ikrXKF7e+VDUK13ijnwGS9YM1c4A@mail.gmail.com
Whole thread Raw
Responses Re: Doc: Fixup misplaced filelist.sgml entities and add some commentary
Re: Doc: Fixup misplaced filelist.sgml entities and add some commentary
List pgsql-hackers
Hi.

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.

I made the choice to move the special %allfiles; reference to the top since placement doesn't matter and burying the one unique thing in the middle of the file didn't seem helpful.  Now both its immediate presence and the comment point out the existence and purpose of ref/allfiles.sgml.

David J.

Attachment

pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: making EXPLAIN extensible
Next
From: Noah Misch
Date:
Subject: Re: AIO v2.5