Natural Docs 1.5 released
July 22nd, 2010
Hey look at that, I’m not dead... again! First the features, then an update on the project.
The biggest new feature is the addition of syntax highlighting. Both prototypes and
You can also use named links instead of just raw URLs and e-mail addresses. This is done with the “at” keyword, which was chosen because it often fits right into the sentence and leaves the source readable: “Visit the <web site at http://www.naturaldocs.org>” becomes “Visit the web site” in the output.
A bunch of minor bugs are fixed as always, but I’m not going to go through them except for one. Natural Docs will now handle files with classic Mac line breaks, which some IDEs apparently still use. This is more of a problem with Perl sucking than Natural Docs, but I’ve successfully worked around it. Perl still chokes on UTF-16 files though.
So anyway, on to the project as a whole. I’ve actually been sidetracked with a different project for the better part of the past year so no real progress has been made in that time. Now that that’s come to a close I’m ready to get back into it. I’m still going to be dedicating most of my time to the C# version because all the old reasons still apply: the engine needs an overhaul and I can’t imagine doing it in Perl. However, unlike before I’m going to occasionally drop back into the Perl code instead of just letting it languish. If there’s a feature that works into the existing architecture easily I’ll add it, and I might backport a few from 2.0.
1.5 illustrates this well. Prettify was something that was fairly easy to tack on. A native highlighter would have been better but isn’t worth the effort at this point. Named links were backported from 2.0 because they fit into the architecture easily. And Perl’s inability to handle Unicode and cross-platform line breaks transparently is another example of why it’s better to switch to something more modern. It wouldn’t be a deal breaker on its own but I have many such examples.
|Copyright © 2003-2011 Greg Valure|