Texinfo files start with at least three lines that provide Texinfo
translators with necessary information. These are the
texinfo line, the
@settitle line, and the
Also, if you want to format just part of the Texinfo file in Emacs,
you must write the
between start-of-header and end-of-header lines. These start- and
end-of-header lines are optional, but they do no harm, so you might as
well always include them.
Any command that affects document formatting as a whole makes sense to
include in the header.
@synindex (see @synindex),
for instance, is another command often included in the header.
Thus, the beginning of a Texinfo file generally looks approximately like this:
\input texinfo @c -*-texinfo-*- @c %**start of header @setfilename sample.info @settitle Sample Manual 1.0 @c %**end of header
(See GNU Sample Texts, for complete sample texts.)
|• First Line:||The first line of a Texinfo file.|
|• Start of Header:||Formatting a region requires this.|
|• @setfilename:||Tell Info the name of the Info file.|
|• @settitle:||Create a title for the printed work.|
|• End of Header:||Formatting a region requires this.|