@top
Sectioning Command ¶The @top
command is a special sectioning command that you
should only use after a ‘@node Top’ line at the beginning of a
Texinfo file.
It produces the same sort of output as @unnumbered
(see @unnumbered
, @appendix
: Chapters with Other Labeling). In LaTeX \part*
is used.
@top
is ignored when raising or lowering sections. That is,
it is never lowered and nothing can be raised to it
(see Raise/lower Sections: @raisesections
and @lowersections
).
It used to be conventional to wrap the ‘Top’ node
in an @ifnottex
conditional so that it would not appear in
printed output (see Conditionally Visible Text). Thus, a Top node often looked
like this:
@ifnottex @node Top @top your-manual-title very-high-level-summary @end ifnottex
This is no longer necessary, as the ‘Top’ node is now never output for printed output. The ‘Top’ node is not output for DocBook either.