Hi Michael, I've already implemented the language attribute, see this commit https://github.com/doxygen/doxygen/commit/e986e0039de21791bd1fbb1f59b13f58c4a46324
Feedback about the usefulness is very much welcome of course. Regards, Dimitri > On 30 Nov 2014, at 12:35 , Michael Jones <m.pricejo...@gmail.com> wrote: > > Hi, > > I'm sorry to have gone quiet. Do you feel that you have time to look at this? > Or do you think that it is a reasonable feature for someone new to the code > base to try? I could attempt a pull-request and you could provide feedback? > > Kind regards, > Michael > > On Sun, Oct 26, 2014 at 4:02 PM, Michael Jones <m.pricejo...@gmail.com> wrote: > Hi, > > Thank you for the quick response. I'm glad you think the project is > interesting and I am very grateful for the links you provide to Breathe from > your documentation. > > It is good to know Doxygen stores the language for the definitions. For > Breathe, it certainly would be useful to have the source language in the XML > output as it seems the code needs to make similar rendering decisions as your > HTML output code does. I'm not sure how best to represent it or at what level > to have it specified. I imagine you have a good feel for that. Being > inexperienced at Objective-C I get confused, but I guess the ability to mix > Objective-C and plain C style declarations means it would have to go on each > definition rather than any higher up. > > If you think it is acceptable for the XML output then great, if you can see a > better approach then I'd be happy to learn. Thanks again. > > Kind regards, > Michael > > > On Sun, Oct 26, 2014 at 11:54 AM, Dimitri van Heesch <doxy...@gmail.com> > wrote: > Hi Michael, > > > On 26 Oct 2014, at 12:15 , Michael Jones <m.pricejo...@gmail.com> wrote: > > > > I am the maintainer of an open source project called Breathe which relies > > on the excellent xml output from Doxygen to include Doxygen processed code > > & comment information in Sphinx documentation. > > A very interesting project! > > > Breathe has generally focussed on C & C++ output but recently we've had > > requests to support Objective-C code as well which has very different > > formatting. As Breathe doesn't know any better it attempts to stick the > > information in the XML together as if it is C style output and so produces > > a bit of a mess for Objective-C style declarations. > > > > I am curious how doxygen tracks that a particular declaration should be > > output as Objective-C and how that might be reflected in the XML output in > > such as way that Breathe might take advantage of it. > > > > Unfortunately, I know very little of Objective-C so I don't really know > > what I am looking for. That said, from an inspection of the XML output for > > an example Objective-C interface the only clues I can see are that the > > 'ids' begin with 'interface' and that there are strangely placed square > > brackets and colons in the definition & param values :) > > > > Is the 'interface' prefix sufficient information in this case? Is there > > another way of determining that Objective-C might be involved? > > Doxygen internally keeps track of which language a symbol is written in (see > Definition::getLanguage()). > This information is partly based on the file extension (and EXTENSION_MAPPING > setting) and is for Objective-C also based on specific keywords found in the > header file. > > So far this information is not written to the XML output, but it would not be > hard to add this if that would help you. > > Regards, > Dimitri > > > ------------------------------------------------------------------------------ Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server from Actuate! Instantly Supercharge Your Business Reports and Dashboards with Interactivity, Sharing, Native Excel Exports, App Integration & more Get technology previously reserved for billion-dollar corporations, FREE http://pubads.g.doubleclick.net/gampad/clk?id=157005751&iu=/4140/ostg.clktrk _______________________________________________ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users
