17.3 @verbatiminclude file: Include a File Verbatim

You can include the exact contents of a file in the document with the @verbatiminclude command:

@verbatiminclude filename

The contents of filename is printed in a verbatim environment (see @verbatim: Literal Text). Generally, the file is printed exactly as it is, with all special characters and white space retained. No indentation is added; if you want indentation, enclose the @verbatiminclude within @example (see @example: Example Text).

@value{var} references are expanded on the @verbatiminclude line. This makes it possible to include files in other directories within a distribution, for instance:

@verbatiminclude @value{top_srcdir}/NEWS

(You still have to get top_srcdir defined in the first place.)

Other than that, the only @-commands allowed are @@, @{, @} and associated @-commands such as @atchar{}.

For a method on printing the file contents in a smaller font size, see the end of the section on @verbatim.