Time to start wrapping up 2.4. What do we have in store? Five New Languages I've been letting the language list languish for far too long, so now we have five more. Natural Docs now has native support for: Rust Swift Kotlin Go TypeScript All of these languages have mini-parsers written for them, so while they still only have basic language support they each have their own keyword lists for syntax…
New update time. Let's see what I've been up to. Repository Links You can now add links to web-based repository sites like GitHub to your documentation. After you do, whenever you hover over a prototype a tab will pop up with a link to its source code: It works for class prototypes too: But what if more than one file defines something, like how C++ has header and source files? I got you: You can…
It's time for a new development release. What's been going on behind the scenes? Native Binaries I've migrated Natural Docs from the .NET Framework to precompiled .NET 8 binaries. What does that mean for you? The biggest benefit is that Apple-silicon Macs and Windows Snapdragon PCs will be faster and more efficient. They're ARM64 chips, and now we have ARM64 binaries! My testing showed the…
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,…
Time for another release. Let's recap what's new for the people who haven't been following the development releases. Dark Themes Natural Docs now has dark themes. Rather than just being new styles you can choose for your project, you're able to let the user choose which one they want from the browser. Just click the moon icon next to the search box: The dark theme is what you'd expect, and the…
It's been a while. Time to wrap up the development releases and put something out, so I'm calling this one Release Candidate 1. I think it's pretty much ready. Dark Themes I tied up all the loose ends on dark themes. First, your theme choice will now be saved. If you set it to Dark it will still be on Dark the next time you open your documentation. It will also be preserved when you open new tabs…
Time to start a new batch of development releases. What do we have so far? Dark Themes I originally planned on doing some easy, low-hanging fruit features while I worked on SystemVerilog. Adding dark themes turned out to be a bigger effort than I thought, but I'm pretty happy with the results: These aren't just additional styles you can choose when you build your documentation. If you use the…
Natural Docs 2.2 is done! Let's recap for those who weren't following the development releases. Custom Home Pages The first new feature is custom home pages. You can now replace this part of the documentation with anything you want: One option is to set it to a source file using the new Home Page setting in Project.txt. This can be a regular source file or you can create a text file with Natural…
Wrapping up 2.2. Fixed a bug related to resolving links with parameters, so something like <MyFunction(int, int)> will go to the correct definition. Some finishing touches to the updated output style, which are pretty subtle. That's it, plus some internal cleanup work. Since everything seems pretty stable I'm deeming this a release candidate. If nothing pops up in the next few weeks this will be…
I really need to start wrapping up 2.2. So what's new in development release 4? Simpler Options for Custom Home Pages In development release 1 I added the ability to have your own HTML file to serve as the home page instead of the default one. It required creating an advanced style , adding a HTML file to the style's folder, and adding "Home Page: [file name]" to Style.txt. This approach lets you…
Just uplifting some bug fixes from the development releases into the stable releases so you don't have to wait for 2.2. SQL: Fixed a crash, something that could cause prototypes to not show up, and something that could cause prototypes to include too much of the code. Images: Fixed a crash when working with embedded images. 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. Language-Specific Keywords 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…