From c5212c1fcfc170ff7a4e0e52c969ce4e3487d9cf Mon Sep 17 00:00:00 2001 From: Norman Walsh Date: Thu, 10 Oct 2024 18:28:24 +0100 Subject: [PATCH] Attempt to clarify transform-before vs transform original --- src/guide/xml/ch04.xml | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/src/guide/xml/ch04.xml b/src/guide/xml/ch04.xml index 3dcb7bc16..3487d9576 100644 --- a/src/guide/xml/ch04.xml +++ b/src/guide/xml/ch04.xml @@ -602,8 +602,14 @@ document using three parameters: transform-original -This transform runs before step in the standard transformations. -If this transformation is used, it must take special care to preserve the +This transform runs before step +in the standard transformations. Note that this is before XInclude processing, before +transclusion, before any other processing. If you need to make a change to the +original input document, this is where you can do it, but for preprocessing +“the XML document that will be transformed”, the transform-before +parameter is likely to be a better choice. + +If this transformation is used, it must take special care to preserve the base URI of the original document by adding an xml:base attribute to the root element (if it doesn’t already have one). Only the first transformation in the list has access to the original base URI.