ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject DO NOT REPLY [Bug 34116] New: - Example XML syntax for Ant manual + matching XSLs
Date Mon, 21 Mar 2005 22:56:53 GMT
DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG·
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://issues.apache.org/bugzilla/show_bug.cgi?id=34116>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND·
INSERTED IN THE BUG DATABASE.

http://issues.apache.org/bugzilla/show_bug.cgi?id=34116

           Summary: Example XML syntax for Ant manual + matching XSLs
           Product: Ant
           Version: 1.7Alpha (nightly)
          Platform: Other
        OS/Version: other
            Status: NEW
          Severity: enhancement
          Priority: P2
         Component: Documentation
        AssignedTo: dev@ant.apache.org
        ReportedBy: ddevienne@lgc.com


As I've written, I think XML+XSL is the way to go for the future Ant 
documentation. Enclosed are the preliminary results of my recent 
experimentation with defining an XML vocabulary (no DTD or schema, and one 
might be impossible given the choices I'm made...) with matching XSLs.

There's a processing instructions so it loads in an XSL compatible browser. The 
HTML files are original Ant ones for comparison. Note that IE garbles the XML 
because it does not preserve whitespace-only nodes (needs special setup to load 
conformant XSL engine) and that I did not finish the <ant> XML doc example, as 
I was not expecting such a weird example format.

So far I've mostly mimicked the existing Ant docs, but once we have semantic in 
the documentation, we can go crazy with the formatting.

Also enclosed is a XML+XSL prototype for the WHATSNEW file. Provides neat 
little features.

Both of these are addressing the Ant doc issue from the other spectrum I 
started with introspecting the tasks/types from the AntLib definition. This 
will eventually spit more XML to be merged with the manually maintained docs 
(to complement them).

Please feel free to comment or ask questions. Thanks, --DD

-- 
Configure bugmail: http://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org


Mime
View raw message