The $include_numbered
directive is the same as the
$include_preformatted
directive except that it automatically numbers the
lines of the imported file. Line numbers generated in this way can be used as a
reference later in the documentation.
Example: Importing a code example with line numbers
1 Code:
2 $include_numbered 'hello.pas'
3
4 **Line 6** shows how to write a simple message in pascal
5 with ``WriteLn``.
Warning: Syntax highlighting of code examples included in this way may be inaccurate if multiline comments are present. Solutions:
- Use only one line comments.
- Do not use syntax highlighting, ie, import the file as preformatted text (by removing the Code header in example above).