News
Natural Docs 2.3.1 released
February 1st, 2025

Hello all.  Here's a small release to bundle up all the things that have changed since the last one.

The primary reason is because SystemVerilog is about to move from "basic language support with extra formatting code for modules" to the full language support code path.  Once it's on the new path Natural Docs will be able to find modules even if you didn't write comments for them, which is good, but you wouldn't be able to add prototypes for other language constructs via Languages.txt anymore.  You'd have to wait until I build out the parser for them.  So here's a version to let you use the upgraded basic language support while full language support is worked on in the development releases.

There's more improvements than just that though.

Updated Languages
  • SystemVerilog will format module prototypes better.  It also has dedicated module keywords, and if you use them you'll get a top-level Modules menu next to Files and Classes.  If you document the ports using a definition list under a "Ports" or "Parameter Ports" heading it will pull the types into it the same way "Parameters" does for functions.

  • C# now supports file-scoped namespace declarations ("namespace X;" instead of "namespace X { ... }") from C# 10.

  • Tcl has improved parameter detection and formatting.

  • Visual Basic now has property prototypes.  They show the type but not whether get/set are defined.

New Languages
  • PowerShell now has basic language support with custom syntax highlighting.  It doesn't support classes though, just functions and line comments.

  • PowerBuilder now has basic language support with custom syntax highlighting as well.

Odds and Ends
  • The theme switcher got a facelift.  There were minor improvements to how bullet lists are formatted and the black theme's contrast was increased.

  • Natural Docs can now support languages that have nested block comments.  Just add the Block Comments Nest property in Languages.txt.  It's already turned on for Pascal/Delphi and PowerBuilder.

That's it for now.  Due to some personal issues there wasn't much development for almost a year after 2.3, but things have been picking up again these last few months.  I have a new feature I'm going to be attempting plus I'll be continuing to move SystemVerilog towards full support.  Follow the development releases if you want to keep up on that.

Earlier Discuss Share 
Natural Docs 2.3 released: Dark Themes
E-MailCopy Link