Test case document formatting request

Our test cases document [1] incorporates examples using XInclude.  
This is good because it means we include the examples used to test  
code without copying or possibly introducing errors, and can stay in  
sync with latest checked in changes.

However, these examples  get formatted in the test case HTML document  
as a very long horizontal line of XML, presumably due to lack of  
spaces between XML elements.

This is essentially illegible to read, requires horizontal scrolling  
in browser and will not print properly.

Two questions

(1) is there a tool or technique to process the XInclude so that the  
content included is pretty-printed upon inclusion so it flows properly?

(2) would it make sense to add spaces to the examples?

I suggest no to #2,  and not to do this manually for at least two  
reasons

a. No desire to introduce errors or require repeated execution of  
test cases by implementors

b. Tedious at the least to format properly with regard to XML  
hierarchy and document requirements.

(3) is it acceptable to have badly formatted document as a  W3C Note?

Has anyone on the WG dealt with this issue and have a solution?  
Thomas, do you mind asking the team?

  I would think this issue has already been encountered and solved  
and if we can resolve this easily and simply that would be good.

Thanks

regards, Frederick

Frederick Hirsch
Nokia

[1] http://www.w3.org/2007/xmlsec/interop/xmlsig-interop-doc/ 
testcases.html#XMLBASE_C14N11SPEC

Received on Monday, 7 January 2008 16:00:55 UTC