3

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.

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
    Commented Jan 17, 2015 at 19:58
  • 1
    @Steve check this out stack.nl/~dimitri/doxygen, doxys.dk/doxys_homepage/index.html
    – Heisenberg
    Commented Jan 17, 2015 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
    Commented Jan 19, 2015 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:[email protected]?subject=CUDA Toolkit Documentation Feedback: cuRAND), ask what they use and if it is FOSS.
    – Mawg
    Commented Jun 4, 2015 at 13:00
  • 1
    OK, this is 6 months old and Steve can't be bothered to improve it. Downvoting as low quality recommendation request.
    – Ira Baxter
    Commented Jul 31, 2015 at 7:28

1 Answer 1

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.

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
    Commented Dec 3, 2015 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. Commented Dec 3, 2015 at 17:51

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

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