Readable Source Code Documentation
for 25 Programming Languages
![]() | Natural Docs lets you document code written in any of 25 programming languages, plus it can be easily extended for more so whatever you use, it can too. And if your project uses multiple languages, no problem! It will all be included in the same set of documentation. |
Natural Docs also speaks your other language... English! Its comments are designed to be very natural and readable so they're just as usable in the source code as they are in the generated documentation. No weird syntax or tags scattered everywhere. | ![]() |
![]() | Natural Docs' generated documentation is pretty and powerful, with three independently scrolling panels, dynamic menus, search, and pop-up summaries when you hover over links. All its features work wherever you put it, be it a web server, a network share, or just opened from your hard drive. |
If you're new to Natural Docs be sure to read our Getting Started guide and we'll have you up and running in no time. If you've been using Natural Docs 1.5, check out our tour of What's New in 2.0! |
This should be the last update before 2.4. As planned, I spent some time improving support for more existing languages. What I didn't plan on was quite how long C/C++ would take, as it ended up being another one where I had to get a good chunk of the way towards full language support in order to handle all its syntax quirks. But it's done now, as well as improved support for Python and a few other minor improvements. I'm calling this Beta 2 because of all the new code for C/C++, but everyone else can consider this Release Candidate 1. No more new features will be added before release, only bug fixes if people find any. Improved Support for C and C++ C and C++ support is considerably improved. It still only has basic language support, but it has extra code to properly handle things like:
C++ has a lot of quirks (insert "why can't you just be normal??" meme, "char*(ClassName::*SCREAMS(int x))(int)") but it should all work. Let me know if you come across anything that doesn't or formats funny. Improved Support for Python I also did some work on Python. It now has:
Other Language Improvements
HTML Output Improvements
Wrapping Up So that's it. Again, if you're not using C or C++ you can consider this Release Candidate 1. Barring any bugs the next release is 2.4. |