From: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
---|---|
To: | PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org> |
Subject: | Doc: Fixup misplaced filelist.sgml entities and add some commentary |
Date: | 2025-03-19 21:13:17 |
Message-ID: | CAKFQuwb05WkXYPQhdyAVk+ikrXKF7e+VDUK13ijnwGS9YM1c4A@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | 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 | Content-Type | Size |
---|---|---|
doc-reorder-entities-and-comment.diff | text/x-patch | 13.4 KB |
From | Date | Subject | |
---|---|---|---|
Next Message | Noah Misch | 2025-03-19 21:25:30 | Re: AIO v2.5 |
Previous Message | Tom Lane | 2025-03-19 21:10:32 | Re: making EXPLAIN extensible |