<?xml version="1.0" encoding="iso-8859-1"?> <?xml-stylesheet href="../../make-menu.xsl" type="text/xsl"?><html> <head> <this-is section="extensions" page="output-extras" subpage="require-well-formed"/> <!-- Generated at 2011-12-09T20:47:22.916Z--><title>Saxonica: XSLT and XQuery Processing: The saxon:require-well-formed attribute</title> <meta name="coverage" content="Worldwide"/> <meta name="copyright" content="Copyright Saxonica Ltd"/> <meta name="title" content="Saxonica: XSLT and XQuery Processing: The saxon:require-well-formed attribute"/> <meta name="robots" content="noindex,nofollow"/> <link rel="stylesheet" href="../../saxondocs.css" type="text/css"/> </head> <body class="main"> <h1>The saxon:require-well-formed attribute</h1> <p>This attribute affects the handling of result documents that contain multiple top-level elements or top-level text nodes. The W3C specifications allow such a result document, even though it is not a well-formed XML document. It is, however, a well-formed <i>external general parsed entity</i>, which means it can be incorporated into a well-formed XML document by means of an entity reference.</p> <p>The attribute <code>saxon:require-well-formed</code> is available, with values "yes" or "no". The default is "no". If the value is set to "yes", and a SAX destination (for example a <code>SAXResult</code>, a <code>JDOMResult</code>, or a user-written <code>ContentHandler</code>) is supplied to receive the results of the transformation, then Saxon will report an error rather than sending a non-well-formed stream of SAX events to the <code>ContentHandler</code>. This attribute is useful when the output of the stylesheet is sent to a component (for example an XSL-FO rendering engine) that is not designed to accept non-well-formed XML result trees.</p> <p>Note also that namespace undeclarations of the form <code>xmlns:p=""</code> (as permitted by XML Namespaces 1.1) are passed to the <code>startPrefixMapping()</code> method of a user-defined <code>ContentHandler</code> only if <code>undeclare-prefixes="yes"</code> is specified on <code>xsl:output</code>.</p> <table width="100%"> <tr> <td> <p align="right"><a class="nav" href="supply-source-locator.xml">Next</a></p> </td> </tr> </table> </body> </html>