18.5 @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). 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).

The name of the file is taken literally, with a single exception: @value{var} references are expanded. 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.)

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