Re: [Doxygen-develop] DITA XML Support Status

[Joel S. <joe...@oa...>]

On 07/06/2011 09:28 AM, jon...@no... wrote:
> Hi, Joel.
>
> Latest patch and binaries now uploaded to https://projects.developer.nokia.com/doxygen_dita/files/.
>
>> When you say latest, do you mean svn or 1.7.4?
> Binaries were built against a svn checkout from today, but the patch should apply cleanly to the last stable doxygen release also.
>
>> Other that the obvious reports of success or details on problems, what type of feedback would you like?
> Where you think the format (dtd) could be improved, feature requests, bug reports etc.
>
>> It would be good to get this merged so it because more mainstream.
> I have created an "enhancement" on doxygens bugzilla and applied the patch so probably best to continue the conversation over there. The url is: https://bugzilla.gnome.org/show_bug.cgi?id=654087.
>
Thanks for the quick update but the patch doesn't build for me:

xmlditagen.cpp: In member function ‘QString 
DITAGeneratorBase::nameLookup(const MemberDef*) const’:
xmlditagen.cpp:1326:14: warning: unused variable ‘pN’
xmlditagen.cpp: In member function ‘void 
DITAFileGenerator::generateXMLForFile(FileDef*)’:
xmlditagen.cpp:2443:18: warning: unused variable ‘nd’
xmlditagen.cpp: At global scope:
xmlditagen.cpp:2593:6: warning: unused parameter ‘dl’
xmlditagen.cpp:2593:6: warning: unused parameter ‘xt’
xmlditagen.cpp:2638:6: warning: unused parameter ‘outDir’
xmlditagen.cpp: In function ‘void generateXML(QCString)’:
xmlditagen.cpp:2667:67: error: cannot pass objects of 
non-trivially-copyable type ‘class QString’ through ‘...’


I added a .data() to the use of QString ix and it compiles
now. I haven't looked at the warnings or used the
executable yet.
>> We try not to have quirky code in RTEMS but it wouldn't surprise me if someone else found it quirky.  We use a lot of static inline methods to encapsulate functionality in an OO style.
> I am sure the kernel engineers here would take exception to my use of the word "quirky" :), but I'm not as smart as those guys so some of it looks "quirky" to me.
>
:)
>> I am just getting started on this experiment.  Is there a good guide for the process of getting from Doxygen all the way to the Information Centre?
> None that I know off. Once you get doxygen outputting the dita xml running the DITA OT with our plug-in should get you most of the way there (DITA OT supports outputting as Eclipse jar files). We need to use 64bit java and give it a LOT of ram to get it to build all of Symbian OS so that might be something to watch out for.
>
OK. I will just beg for help and collect the resulting notes into a howto
so others have an easier path.
> Regards,
> Jonathan.


-- 
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