17.1 How to Use Include Files

To include another file within a Texinfo file, write the @include command at the beginning of a line and follow it on the same line by the name of a file to be included. For example:

@include buffers.texi

@value{var} references are expanded on the @include line. Other than that, the only @-commands allowed are @@, @{, @} and associated @-commands such as @atchar{}.

An included file should simply be a segment of text that you expect to be included as is into the overall or outer Texinfo file; it should not contain the standard beginning and end parts of a Texinfo file. In particular, you should not start an included file with a line saying ‘\input texinfo’; if you do, that text is inserted into the output file literally. Likewise, you should not end an included file with a @bye command; nothing after @bye is formatted.

In the long-ago past, you were required to write an @setfilename line at the beginning of an included file, but no longer. Now, it does not matter whether you write such a line. If an @setfilename line exists in an included file, it is ignored.

GNU Emacs Texinfo mode provides texinfo-multiple-files-update to update node pointers and master menu with multiple include files. See Update Outer File and Include Files.