Suppose you want to produce XML documentation that contains a document type declaration or an internal subset. You need an escape hatch:
<src:fragment id="top"> <src:passthrough><!DOCTYPE PUBLIC "-//Example//..." "http://..."></src:passthrough> <config xmlns="http://example.org/fabricated"> <option name="foo" value="bar"/> <option name="baz" value="foo"/> </config> </src:fragment> </div>
Produces:
<!DOCTYPE PUBLIC "-//Example//..." "http://..."> <config xmlns="http://example.org/fabricated"> <option name="foo" value="bar"/> <option name="baz" value="foo"/> </config>