Readable Source Code Documentation
for 21 Programming Languages
Natural Docs lets you document code written in any of 21 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.
Just uplifting some bug fixes from the development releases into the stable releases so you don't have to wait for 2.2.
That's it. If you don't use either of those you're safe skipping this one.
New development release. As I said last time I'm laying some groundwork for the future, so the new features probably won't be very exciting but they're important for Natural Docs going forward.
So here's the issue: "Record" means one thing in C# and another thing in SQL. "Module" means one thing in SystemVerilog and another thing in Perl. So while there is still only one set of comment types in Comments.txt, you can now add keywords for them that only apply to certain languages. This probably doesn't mean much to you because if you're customizing Natural Docs for the languages you use it doesn't matter if you step on the ones you don't. However, it's good for Natural Docs itself because now these distinctions can be supported out of the box without any customizations.
Consequently, "Record" now only serves as a keyword for "Class" in C# to prevent unexpected behavior in other languages.
However, this also means all the database keywords can now be used without a prefix in SQL files. You can just use "Table" or "Field" instead of "Database Table" or "DB Field".
Bug Fixes and Tweaks