Bug 109159

Summary: Make Splitter work with XML files
Product: [Retired] Red Hat Web Application Framework Reporter: Justin Ross <jross>
Component: documentationAssignee: Rafael H. Schloming <rafaels>
Status: CLOSED WONTFIX QA Contact: Jon Orris <jorris>
Severity: medium Docs Contact:
Priority: medium    
Version: nightlyCC: jross, kwade, tross
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2005-09-28 21:37:29 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Justin Ross 2003-11-05 06:04:19 UTC 
Description of problem:

Splitter is a very handy tool for generating program listings in
documentation, but it doesn't work well for XML "programs".  Two
reasons for that:

1. "<!-- @rhdoc.begin foo.sgml -->" does not work because the trailing
"-->" is not stripped away.

2. XML documents do not allow comments preceeding the <?xml?>
declaration or otherwise outside the root element.  If you want to
insert an entire XML document as an example listing, you will not be
able to bracket it with XML comments and still have working code.