[oXygen-user] XProc documentation

[Toman, Vojtech]

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 at emc.com
http://developer.emc.com/xmltech


> -----Original Message-----
> From: oxygen-user-bounces at oxygenxml.com [mailto:oxygen-user-
> bounces at 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 at oxygenxml.com
> http://www.oxygenxml.com/mailman/listinfo/oxygen-user