Re: Texinfo @section level error

On Saturday, April 25th, 2026 at 10:06 AM, Patrice Dumas <[email protected]>=
 wrote:

> On Fri, Apr 24, 2026 at 08:43:44PM +0000, Heime wrote:
> > On Saturday, April 25th, 2026 at 8:38 AM, Patrice Dumas <pertusus@free.=
fr> wrote:
> >
> > > On Fri, Apr 24, 2026 at 07:31:07PM +0000, Heime wrote:
> > > > ----------------------------------------------------------------
> > > > Why do I get "antares.texi:18: raising the section level of @sectio=
n
> > > > which is too low"?
> > >
> > > That is because there is a gap betweenn @top and @section, there shou=
ld
> > > be a @chapter or similar (@unnumbered, @appendix) between the @top an=
d
> > > the @section.
> >
> > Do program manuals use chapters?
>=20
> Yes, they do.
>=20
> >  Is the suggestion to always use at least
> > one of @chapter, @unnumbered, or @appendix as top level declaration?
>=20
> Yes.  (Not technically top level, as @top is even more top level, as is
> @part).
>=20
> --
> Pat

I could not see in the manual, the minimal working document possibilities,
Or the usual structuring for various types of documents.  Would doing so=20
make the manual too difficult to understand?
 =20
Examples like

\input texinfo

[@part]
@chapter/@unnumbered/@appendix
[@section]
[@appendix]

@bye