03/06/06 - DocJet version 5.3 build 1 released
This release includes support for Generics in C#, a substantially rewritten user manual, and the ability to break your Table of Contents description file (DJX file) into smaller chunks. Also, the substantial improvements have been made to the way overloaded methods are documented. The output formats have been changed to use Positional CSS rather than tables for many formatting tasks.
Before you install this release...
Substantial changes have been made to the output formats. In particular, the "Heading" and "Trailer" output type functions have been substantially modified. They have also been broken down a bit so that future changes to these methods will not have such a dramatic impact. Also, the stylesheets have been modified substantially as well.
New Features
- The DJX file format, which used to be binary, is now XML. Also, you can now include one DJX file from another, which allows you to create separately managed and maintained TOC branches.
- You can now document overloaded functions on a per-overload basis, rather than the old way which forced you to have a single "Remarks" section, etc. that covered the returns from all overloads. For more on this, see "Documenting Overloaded Functions" in the on-line help. If you are using XML comments, then you can simply start using NDoc's <overloads> markup, which is supported as well.
- The Internal and New Standard output formats have been changed to use Positional CSS for most of the formatting that formerly was done with tables.
- DocJet now supports Generics in C#. (But not in VB.Net or the generic equivolent in C++ yet.)
Defects Corrected
- The User Manual has been substantially revised.
- The C# syntax class C { int prop { get {} *private* set {} } } now works correctly