You might be interested in http://github.com/vojtechtoman/xprocdoc, an Javadoc-style XProc documentation generator written in XProc. It collects p:documentation (free form XHTML) from p:library, p:pipeline, p:declare-step, p:input, p:ouput, and p:option and builds a linked set of XHTML pages out of it. It also understands p:import statements. Note, however, that I just discovered that Calabash chokes on it. I am in the process of fixing that. Regards, Vojtech -- Vojtech Toman Consultant Software Engineer EMC | Information Intelligence Group vojtech.toman@emc.com http://developer.emc.com/xmltech
-----Original Message----- From: oxygen-user-bounces@oxygenxml.com [mailto:oxygen-user- bounces@oxygenxml.com] On Behalf Of Florent Georges Sent: Tuesday, February 19, 2013 12:02 PM To: Jostein Austvik Jacobsen Cc: oXygen User ML Subject: Re: [oXygen-user] XProc documentation
Jostein Austvik Jacobsen wrote:
Hi Jostein,
I would be interested in this as well. Is there any documentation conventions/vocabularies in use for XProc documentation?
None that I am aware of, unfortunately. What I do is I use standard p:documentation elements with either XHTML p elements or DocBook para elements. Waiting for a documentation tool to appear, or to write one myself, which will support one or the other most likely.
Actually that is close enough to what is done for XSLT in oXygen that I feel it should not be too much work to adapt to XProc the existing oXygen support for documenting XSLT.
If only there was an XML vocabulary to represent Javadoc-like docs, it would be easy to generate them from XProc and let formatting tools do the presentation ;-)
Regards,
-- Florent Georges http://fgeorges.org/ http://h2oconsulting.be/ _______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com http://www.oxygenxml.com/mailman/listinfo/oxygen-user