Re: Regarding outline headings in emacs-lisp libraries

[Stefan Monnier]

[ sorry, I somehow missed the end of your message on first reading.  ]

> B) The OVERVIEW shown above isn't just not useful, for more complex
>    libraries (which are split into more (sub*)sections) having a useful
>    OVERVIEW is quite important.
>
>    For such libraries the TOC just isn't a suitable substitute for
>    OVERVIEW.  It could be deeply nested and if one only wants a list
>    of the "major sections of a program", then a deeply nested tree of
>    sub*sections just isn't the same.

I guess what I was saying in my previous message is that I haven't found
a case of a file where the TOC is so large that it warrants the OVERVIEW.
And I'd even claim that such a file would be just too large and should
likely benefit from splitting it into a few files.

> Pps: When one often collapses sections, then the ";;; NAME.el ends here"
>      becomes very annoying.  I am glad to have learned recently that as
>      early as Emacs 31.1 that line won't be mandatory anymore. ;P

I think you missed the episode where they explain that it was
re-introduced in Emacs-31.2 because of all the complaints from people
who couldn't find the end of their code any more.


        Stefan