Doc: Fixup misplaced filelist.sgml entities and add some commentary

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

Responses

Browse pgsql-hackers by date

  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