Re: [Doxygen-develop] DITA XML Support Status

[<pau...@no...>]

Hi Joel,

> You mention this for C++, does it work for C as well?

Yes this will work for C, you probably want to set OPTIMIZE_OUTPUT_FOR_C = YES in your config file.

The discrepancy will be is that we treat, for the moment, C input as C++ so that the DITA output will be to the DITA C++ specialisation. There is not yet a DITA specialisation for C. There is some interest in OASIS in creating a Technical Sub-Committee for Programming Languages that could share the burden of creating specialisations but the sub-committee is not yet formed.

If a specialisation for C were to exist then our patch could write to it because it decides output formats dynamically from any inputs that Doxygen can take (see line 25 onwards in xmlditaelementprefix.cpp).

So for the moment, yes, it will take C input but produce DITA to the C++ specialisation. Let us know how you get on!

Best regards,

Paul Ross.

> -----Original Message-----
> From: ext Joel Sherrill [mailto:joe...@oa...]
> Sent: 05 July 2011 23:20
> To: dox...@li...; Harrington Jonathan (Nokia-
> SD/London)
> Subject: [Doxygen-develop] DITA XML Support Status
> 
> > Hi,
> >
> > We are currently working on a DITA XML specialization for the C++
> programming language. As part of the work we have implemented a backend
> for doxygen which produces DITA XML from C++ source code, a documented
> standard and a plug-in for the DITA open toolkit.
> >
> > We have been using the standard, the doxygen backend and DITA open
> toolkit plug-in in production for over a year now to produce the
> Symbian developer library and we feel they are stable enough to start
> donating them to the appropriate upstream projects. We are have started
> discussions with Oasis about approving the C++ standard and our plug-in
> is already available for download on the DITA open toolkit website.
> >
> > I was wondering if anyone else in the doxygen community would be
> interested in this work and if there is any desire to see it integrated
> back up stream? I have attached a patch that adds DITA xml support to
> doxygen. We have tested the patch on windows, Linux and Mac OS X and
> would be happy to support it (fix any defects raised, implement feature
> requests etc.) for the foreseeable future.
> >
> > Patch can be downloaded
> fromhttp://www.skynet.ie/~jonathan/dita_patch.diff.gz
> <http://www.skynet.ie/%7Ejonathan/dita_patch.diff.gz>
> >
> > Regards,
> > Jonathan.
> 
> What are the plans for merging this into Doxygen?
> 
> You mention this for C++, does it work for C as well?  I am
> looking at this as a path to getting the RTEMS Doxygen
> generated documentation into the Eclipse Information Center.
> 
> Thanks.
> 
> --
> Joel Sherrill, Ph.D.             Director of Research&  Development
> joe...@OA...        On-Line Applications Research
> Ask me about RTEMS: a free RTOS  Huntsville AL 35805
>     Support Available             (256) 722-9985
> 
> 
> 
> -----------------------------------------------------------------------
> -------
> All of the data generated in your IT infrastructure is seriously
> valuable.
> Why? It contains a definitive record of application performance,
> security
> threats, fraudulent activity, and more. Splunk takes this data and
> makes
> sense of it. IT sense. And common sense.
> http://p.sf.net/sfu/splunk-d2d-c2
> _______________________________________________
> Doxygen-develop mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-develop