Next: , Previous: verbatim, Up: Quotations and Examples


10.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 reliably include files in other directories in a distribution, for instance:

     @include @value{top_srcdir}/NEWS

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