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

On Wed, Mar 19, 2025 at 2:31 PM Marcos Pegoraro <marcos(at)f10(dot)com(dot)br> wrote:

> Em qua., 19 de mar. de 2025 às 18:14, David G. Johnston <
> david(dot)g(dot)johnston(at)gmail(dot)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.