[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Regarding outline headings in emacs-lisp libraries

From: Stefan Monnier
Subject: Re: Regarding outline headings in emacs-lisp libraries
Date: Fri, 17 Jul 2020 23:29:50 -0400
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux)

[ 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.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]