Re: control over sectioning and splitting

[Per Bothner]

On 10/10/21 07:10, Patrice Dumas wrote:
> I am probably missions something, but isn't what you want obtained with
> --split=chapter and using sectioning commands like @section,
> @subsection?

The issue is that there are some topics (chapters) that are large enough
to want to split into multiple pages for various reasons: big pages are
more overwhelming; the chapter topic naturally devides into several
semi-independent sub-topics; there may be external links one would
prefer not to break.

So one could promote each sub-topic to its own chapter, but that loses the
organization and clutters up the sidebar.  At least for something
intended as a "landing" page (home page) it is highly undesible to have
too many "starting topics" in the initial sidebar, since an over-busy home page
may drive people away.

The fundamental problem is that texinfo assumes page-splitting at a
particular level on the hierarchy, but that is too inflexible: It makes
for a non-optimal browsing expeience.
--
        --Per Bothner
per@bothner.com   http://per.bothner.com/