From ffa8860fb3ac39bc134fd6f04412f2cf809a4383 Mon Sep 17 00:00:00 2001 From: Haris Skiadas Date: Mon, 29 Dec 2025 13:15:04 -0500 Subject: [PATCH 1/4] Amend doc to suggest using xi:include in place of pre@source in datafiles. --- doc/guide/author/topics.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/guide/author/topics.xml b/doc/guide/author/topics.xml index 479851541..3323c81cf 100644 --- a/doc/guide/author/topics.xml +++ b/doc/guide/author/topics.xml @@ -3866,7 +3866,7 @@ 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.

 From 27885542f6a932c3351d5aee3d46a043069bb1f7 Mon Sep 17 00:00:00 2001 From: Haris Skiadas Date: Mon, 29 Dec 2025 13:15:38 -0500 Subject: [PATCH 2/4] Adjust example in rune.xml to use xi:include instead of pre@source --- examples/sample-book/rune.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/examples/sample-book/rune.xml b/examples/sample-book/rune.xml index 1477bddb2..4197dc8ab 100644 --- a/examples/sample-book/rune.xml +++ b/examples/sample-book/rune.xml @@ -874,7 +874,7 @@ TEST_CASE( "Test the add function" ) {

- 
+                

             
         
 

From 5c2907a937af088fe77a2ddc12a69ea79332c7c0 Mon Sep 17 00:00:00 2001
From: Haris Skiadas 
Date: Mon, 29 Dec 2025 13:16:33 -0500
Subject: [PATCH 3/4] Remove commented out example of pre@source

---
 examples/sample-book/rune.xml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/examples/sample-book/rune.xml b/examples/sample-book/rune.xml
index 4197dc8ab..c4b999b3d 100644
--- a/examples/sample-book/rune.xml
+++ b/examples/sample-book/rune.xml
@@ -2292,7 +2292,6 @@ TEST_CASE( "Test the add function" ) {
             } // end of SimplePicture class
             ]]>
- @@ -3495,7 +3494,7 @@ TEST_CASE( "Test the add function" ) { matching function types

- Sort the following functions into their correct categories. + Sort the following functions into their correct categories.

From f2b9da8aa8ce5758323b6951e95b87b6921f846a Mon Sep 17 00:00:00 2001 From: Haris Skiadas Date: Mon, 29 Dec 2025 14:02:51 -0500 Subject: [PATCH 4/4] Add a deprecation notice for pre@source in datafiles. --- xsl/pretext-common.xsl | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/xsl/pretext-common.xsl b/xsl/pretext-common.xsl index abbe3a838..9d81d3f31 100644 --- a/xsl/pretext-common.xsl +++ b/xsl/pretext-common.xsl @@ -12138,6 +12138,13 @@ http://andrewmccarthy.ie/2014/11/06/swung-dash-in-latex/ + + + + + + +