<?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>