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.