Re: [Doxygen-users] are document generators dead?

On Mon, 2014-10-06 at 22:03 -0700, Tom Johnson wrote: > Are document generators for APIs dead? When I look over the possible > options out there, everything seems built about 10 years ago. I don't > see anything new coming out of this genre of tools. I find this odd, > given that APIs themselves a

Re: [Doxygen-users] are document generators dead?

At Mon, 6 Oct 2014 22:03:20 -0700 Tom Johnson wrote: > > > > Are document generators for APIs dead? When I look over the possible > options out there, everything seems built about 10 years ago. I don't see > anything new coming out of this genre of tools. I find this odd, given that > APIs the

Re: [Doxygen-users] are document generators dead?

Doxygen is excellent and especially useful for C/C++ or "like-minded" languages. A few years ago I switched to developing most of my code in Python and while Doxygen can handle this, it is not ideal, in that case I turn to Sphinx which is ideal for Python but also useful for general purpose API d

Re: [Doxygen-users] are document generators dead?

Thanks for your response. Looking at the document generators as a solved problem seems like a okay argument. If the problem were solved 10 yrs ago, why is there any need for additional development? Well, technology is rapidly changing, so there are always opportunities for enhancements and further

Re: [Doxygen-users] are document generators dead?

Tom, You are talking about DITA, what kind of tools for converting DITA are you using / thinking about? Are they able to import e.g. the HTML as generated by doxygen or the XML that can be generated by doxygen? Albert On Tue, Oct 7, 2014 at 6:21 PM, Tom Johnson wrote: > Thanks for your respons

Re: [Doxygen-users] are document generators dead?

I have been exploring two models with DITA. The first model is to import source comments directly into DITA (thus not using Doxygen at all). There are some DITA plugins that work for Java and C++, but nothing for C#. As far as I can tell, the plugins work okay. I haven't explored them too deeply ot

Re: [Doxygen-users] are document generators dead?

Tom, As far as I know DITA is a methodology (Darwin Information Typing Architecture) and not a tool. The tools I'm aware of are Serna and DITA-OT. For the latter wikipedia (http://en.wikipedia.org/wiki/DITA_Open_Toolkit) states: It includes a tool for migrating HTML

Re: [Doxygen-users] are document generators dead?

You are correct. DITA is an XML standard, not a tool. I use OxygenXML as an editor to validate my DITA content. I have explored the HTML to DITA transform, and added some notes about using it here ( http://idratherbewriting.com/ditaqrg/#convert_html_to_dita.html), but honestly it's not an easy proc

[Doxygen-users] · and   cause an error

search = ∑k = 2 ·· n  nCk Causes warnings I'm trying to generate a mathematical statement (sum(k = 2 .. n) immediately followed by the combinatoric statement, nCk and get doxygen warnings. The HTML output looks ok in a browser. Is there any way of suppressing the warnings? All of the m

Re: [Doxygen-users] · and   cause an error

Hi Arthur, For such complex formulas it is much better to use LaTeX notation, i.e. /** The maximum number of searches to find a partition is * \c search = \f$\sum\limits_{2..n}^k{n \choose k}\f$ */ If you don't have LaTeX installed you could enable MathJax to render the formula at the client

Re: [Doxygen-users] are document generators dead?

Hi Tom, There was a patch made a couple of years ago to add DITA support to doxygen, it can still be found here: http://sourceforge.net/p/doxygen/mailman/message/27204707/ I haven't integrated it, because I saw very little interest in it so far. Maybe you want to help to get it up to date again?

Re: [Doxygen-users] are document generators dead?

Awesome. It's good to learn there was a patch made. I found a corresponding thread about the DITA output from Doxygen here: https://www.linkedin.com/groups/How-can-I-generate-DITA-3709151.S.5890104139333001219 I will have to explore this in the coming days/weeks to evaluate how it all works. Overa