Text as Data Files
- Inside of a datafile place an pre element. There are then two options: provide the contents of the text file right in your source file, as you might for other preformatted text, or supply a source attribute whose value is the name of an external text file you provide. The former is appropriate for toy
examples, while the latter may be used for serious
files with many lines, or with long lines. Note that if you provide the file as the content of the pre element, it can be indented to match your source file indentation, and will undergo some manipulation, such as removing leading whitespace, and ensuring a final newline, but preserving any relative indentation. If provided via a source attribute, there is no manipulation.
+ Inside of a datafile place an pre element. There are then two options: provide the contents of the text file right in your source file, as you might for other preformatted text, or use a xi:include element to include the external text file you provide. The former is appropriate for toy
examples, while the latter may be used for serious
files with many lines, or with long lines. Note that if you provide the file as the content of the pre element, it can be indented to match your source file indentation, and will undergo some manipulation, such as removing leading whitespace, and ensuring a final newline, but preserving any relative indentation. If provided via a xi:include tag, any spacing in front of that tag will be preserved and the contents of the linked file will not be indented to match it, so you may prefer to place that tag at the same line as the enclosing pre tag to avoid any extra spacing at the start.
Such a text file may be declared editable by the reader, presumably to allow them to witness the resulting behavior of a some employing program. The rows and cols attributes describe the viewport into the file provided in the HTML output. Typically scrollbars will allow the reader to survey all of a large file. In static outputs, the first few lines are shown, given by the value of rows, and lines are truncated according to the value of cols.
diff --git a/examples/sample-book/rune.xml b/examples/sample-book/rune.xml
index 1477bddb2..c4b999b3d 100644
--- a/examples/sample-book/rune.xml
+++ b/examples/sample-book/rune.xml
@@ -874,7 +874,7 @@ TEST_CASE( "Test the add function" ) {