09/07/02 - DocJet version 5.0 build 1 released

This releases fixes a longstanding problem with overloaded functions. You couldn't have one overload be private and the other overload be public. For instance, if you create a class with a private copy constructor and your intent was to prevent users from copying the object. In this case, the copy constructor would show up in the documentation intermingled with constructors that the user really could call. The second major change is in the handling of HTML documents. You can now create HTML design documents that get the same page-treatments (headers, footers, etc.) that the other pages in your documentation get. This helps to create a more consistent look throughout your documentation.

Before you install this release...

If you have a user-created hook, you need to recompile it. The IDL has changed slightly: IObject now supports a couple of new properties. The signature of ICustomGenerator.Generate has been changed a little bit too, but it's very unlikely that this will affect anybody. The output formats have changed in a couple of minor ways. The one most likely to be felt is the new topics that were added to support the new style of HTML document.

New Features

There is a checkbox in the External Sources Editor's dialog for HTML files that allows HTML files to be given the same headers and footers that the rest of the DocJet sources have. (That is, the top bar - the links to the class hierarchy, design documents, etc.) This checkbox is turned OFF by default when you upgrade an older DJX file!

Defects Corrected

Overloading did not work well if some of the overloads were public and some where private.
The popup boxes (glossary terms, quickhelp for topics, parameters, etc.) were getting a little bit bigger each time you opened one on a page. Switching pages reset them to their original size.
.PAG should be an extension for VB6.
The IDL scanner would get the return type wrong if it came on a different line from the name of the function.
If a license is renewed by the generator, the license server still thought the old license is still in use.
The VB6 scanner wasn't dealing with optional arguments with default values properly.
The C++ scanner had a heuristic to recognize the macros commonly used to apply dll-export to the class, but with forward declarations it only worked some of the time.
The VB scanner was using the "Exposed" attribute to control whether a class or form was published or not. For ActiveX and OLE control projects, this was a great thing. For applications, where all classes would be considered private, this was a horrible thing. A step has been added to the wizard to help with this.
Argument Hook was stupid - it used the punctuation of the section (the " - " between the argument and the comment) to distinguish parts of the section. It has now been improved so that it focuses on the argument names and indentation - it no longer even needs the punctuation.
The output format editor could crash if you held your mouth just right when inserting a paragraph level procedure and then fanatically clicked below the bottom of the text.
The External Sources Editor would crash if you tried to move a representation of a group coming from another source (say overview.gls).
Again in the ESE, Namespaces were reported as a group coming from another source, rather than as an object. That meant that you couldn't move them into another group, make them secret, or much of anything.