4

I want to automatically generate HTML documents for C++ code and have used Doxygen in the past, but if I, for example, look at the NVIDIA CUDA documentation, there must be better tools ;-)

Does anyone know a document generation tool with comparable quality. Wikipedia has a large comparison page but it is so large that it fails to be useful for a recommendation.

Improve this question
5
  • 1
    With all respect Steve, but your question also fails to be useful for a recommendation. If you do not give criteria that the software needs to match, how can anyone make a recommendation? Just pointing to the NVidia example is not enough. – user416 Jan 17 '15 at 19:58
  • 1
    @Steve check this out stack.nl/~dimitri/doxygen, doxys.dk/doxys_homepage/index.html – Heisenberg Jan 17 '15 at 20:36
  • Can you tell us what you don't like about the NVIDIA documentation? Are there any features which are "must have" or "nice to have"? It's difficult to recommend when we don't know hat you are looking for. – Mawg says reinstate Monica Jan 19 '15 at 13:55
  • 1
    Personally, I don't see it as being so much better than Doxygen. But, if you won't give us a list of requirements, an o/s, or a budget, then we can only suggest that you use whatever NVDIA used. I don't see any mention of it on the page, but you could always contact them at their feedback link (mailto:cudatools@nvidia.com?subject=CUDA Toolkit Documentation Feedback: cuRAND), ask what they use and if it is FOSS. – Mawg says reinstate Monica Jun 4 '15 at 13:00
  • OK, this is 6 months old and Steve can't be bothered to improve it. Downvoting as low quality recommendation request. – Ira Baxter Jul 31 '15 at 7:28
3

I can strongly recommend Sphinx Document generator - for an example site take a look at the new wxPython documentation.

Generates documentation from:

  • Python code
  • C/C++ code
  • reStructuredText3
  • Multiple output formats - HTML (including Windows HTML Help), LaTeX (for printable PDF versions), ePub, Texinfo, manual pages, plain text
  • Code Highlighting for a wide range of languages
  • Themes
  • Index & TOC Generation

Free and cross platform.

Improve this answer
2
  • Your link is to a Wiki - does Sphinx generate that as well (or feeds content into an existing wiki)? Also, how is it different/better than doxygen? – einpoklum Dec 3 '15 at 9:19
  • 2
    Sphinx generates the wxPython documentation & wiki AFAIK - the OP said that they "didn't like" the look of the Doxygen generated documents - Sphinx has a number of more modern templates out of the box and lots of customisation options. – Steve Barnes Dec 3 '15 at 17:51

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.