Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 6 years ago.
Improve this question
I know that it is possible to use markdown inside comments and doxygen can understand it. But I need to know if it is possible to generate the documentation in markdown format?
I need these documentation to be generated from C++ files.
I know this question is old but there seems to be a new tool available: https://www.npmjs.com/package/doxygen2md
I don't know of anything that will do it directly, but doxygen has the ability to output an XML document using the XML generator.
There are various projects out there that can then consume said XML data to transform it, one of the simplest ones that I am aware of is Breathe which is used to convert the XML documents to something that Sphinx can use to output documentation using doxygen as a pre-processor so to say.
The code for Breathe may be simple enough to use as a starting point to then generate Markdown files instead of the ReStructuredText files that Sphinx requires. I haven't looked at the code for Breathe, but I have used it for some major projects.
Generate XML with doxygen http://www.doxygen.nl/manual/customize.html#xmlgenerator.
Use PanDoc http://pandoc.org/
to convert XML to Markdown.
Related
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 3 years ago.
Improve this question
there's already a topic about it but I haven't found a helpful answer (http://stackoverflow.com/questions/1316320/a-c-code-generator-from-an-xml-spec).
I'm looking for a library or a tool which can read xsd grammar and then can write a corresponding object in c++ (.hpp, .cpp,...).
Except codesynthsesis, does someone know much about it?
There is a huge list of data binding code generators on http://www.w3.org/XML/Schema , just search the site for C++. Also please describe in detail why the answers on A C++ code generator from an XML spec weren't helpful.
The information at http://www.rpbourret.com/xml/XMLDataBinding.htm can be very helpful. But beware that the list of tools on that web site is slowly getting out of date. The W3C list of data binding tools http://www.w3.org/XML/Schema is outdated (the last update was way back in 2009).
I'm using the GSOAP toolkit from SourceForge for all of my XML C++ projects. Also works for plain C. It binds C/C++ to XML schemas automatically and is fully compliant with industry standards for XML, WSDL, SOAP, REST, XML-RPC, JSON, and WS-* protocols.
GSOAP is actively maintained, easy to use, and pretty efficient too.
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 7 years ago.
Improve this question
I'm looking for open-source projects that make use of two things: (1) C++ and (2) XML data binding. For those who don't know, data binding tools make use of XML schema and code generators such as Codesynthesis xsd, Liquid Technologies. I know CIAO/DAnCE project, an implementation of CORBA Component Model that uses XML Schema Compiler (XSC) but I'm hoping to find more.
I have tried http://www.codesynthesis.com/products/xsd/ a few months back and I thought the resulting C++ interface was pretty clean. (It's style is similar to STL / boost APIs)
Other than that the gSOAP toolkit appears to have something too. ( http://www.cs.fsu.edu/~engelen/soapdoc2.html#tth_sEc1.4 )
Some open source projects that use Codesynthesis XSD are listed on this wiki page:
http://wiki.codesynthesis.com/Open_source_projects_that_use_XSD
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 3 years ago.
Improve this question
I want to scan a PowerPoint 2007 file, but I'm trying to do it with C++. Is there any Open XML parser for C++?
Here's a newly released C library called libOPC which has the same intent as the Open XML SDK, but can be used in all of Linux/Windows/Mac/etc. You can read about it here: libOPC version 0.0.1 released and get the code from CodePlex (be sure to check the documentation page for demo videos).
Not yet. But you can make one. The standards specification files are pretty clear, aren't they ;)
Alternatively you can convert http://phppowerpoint.codeplex.com/ using http://github.com/facebook/hiphop-php
Good luck!
Another option is try c++ binding directly. (more useful when you want to check specific small part of document)
http://wiki.services.openoffice.org/wiki/IDL_Files_and_Cpp#Concrete_Example
There are several.
Xerces is the most comprehensive: http://xerces.apache.org/
TinyXML is popular: http://www.grinninglizard.com/tinyxml/
Expat is my favorite: http://expat.sourceforge.net/
You can find more information on Google : XML parser C++
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 3 years ago.
Improve this question
I'd like to know if there's a tool which allows you to do class definition based on an XML format. I'm not looking for data binding. Anyone can help ?
Thanks
When I had this problem a few years back, I wrote a Python tool to execute Python code embedded in text files so that I could generate C++ code with Python inside the C++: http://nedbatchelder.com/code/cog/
I know of two tools both of them are commercial products
http://www.codesynthesis.com/products/xsd/
Is open source GPL - commercial licence is avalable for commercial use
I think this is/was used by gSOAP
http://www.artima.com/cppsource/xml_data_binding.html
http://www.codalogic.com/lmx/
don't know any more than the web site
I hope this helps.
Update:
Just found this http://en.wikipedia.org/wiki/XML_data_binding#C.2B.2B
Update 2:
This is great, I have been looking for an open source package to do this for ages and your question has just helped my find it:
http://top.touk.pl/confluence/display/xmlbeansxxdoc/Introduction+to+xmlbeansxx
http://top.touk.pl/confluence/download/attachments/458767/Manipulate_XML_Documents_in_CPP_with_xmlbeansxx.pdf
YACC or BISON may be what you are after.
Are UML Class Diagrams what you are looking for?
Closed. This question does not meet Stack Overflow guidelines. It is not currently accepting answers.
We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.
Closed 5 years ago.
Improve this question
I have several projects, some using managed code and some using only unmanaged. All have the XML comments have been added and the XML documentation is being generated correctly (the generated xml file and intermediate the xdc files).
Surely there's something that can take these files (the output of xdcmake) and generate MSDN style chm help! ?
From what I understand, both doxygen and sandcastle ignore that obvious step and re-invent the wheel to re-scan your code. (there's also the fact that sandcastle is apparently useless for non-.NET projects).
Having tried doxygen (horrible output, but fast) and sandcastle (nice MSDN style output, but sloooooow) both are begging to be outdone by something much simpler.
It would also be nice if there was some kind of editor associated that we can also write the 'Getting Started' and 'Information' kind of pages that are also needed with any API documentation.
Does anyone know of any solutions?
You might want to try DoxyComment. Here is the description from Doxygen's Helper tools & scripts:
An addin for Visual Studio 2005 called
DoxyComment was created by Troels
Gram. It is designed to assist you in
inserting context sensitive comment
blocks into C/C++ source files.
DoxyComment also comes with an xslt
template that lets you generate
documentation like the MSDN library.
Honestly, Sandcastle is your best bet. I know it can be a bit of a pain to configure, but the documentation is exactly the style you are looking for.
I know the project where people still use NDocConsole
However I suppose that NDoc is a dead project, because on http://ndoc.sourceforge.net/ there are no updates since 2005