W3C home > Mailing lists > Public > public-xmlsec-maintwg@w3.org > January 2008

Test case document formatting request

From: Frederick Hirsch <frederick.hirsch@nokia.com>
Date: Mon, 7 Jan 2008 11:00:16 -0500
Message-Id: <B4ED7BA7-005A-45EA-9B91-A1B58851B155@nokia.com>
Cc: Frederick Hirsch <frederick.hirsch@nokia.com>, Thomas Roessler <tlr@w3.org>
To: XMLSec XMLSec <public-xmlsec-maintwg@w3.org>

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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:22:03 GMT