Version 1.5.0.0

Version 1.5.0.0 was released on June 25th, 2007.

• Added support for the June 2007 CTP of Sandcastle.

• Fixed a bug that caused a crash when removing private framework field members.

• Fixed a bug in the handling of <exclude/> that caused it to also remove base class members when removing a type.

• Fixed a bug when generating the website table of contents caused by the angle brackets on nested generic types.

• Fixed a bug in ShowMissingComponent caused by incorrect handling of generic template parameter names.

• Fixed a bug in the code colorizer that caused it to match some pre tags incorrectly. Also fixed the "include file" regular expression so that it didn't match similar looking managed C++ generic declarations.

• Fixed inconsistent handling of the tab size property in both the code colorizer and the code block component.

• Added managed C++ keywords to the C++ colorizer template.

• The list of assemblies to document is now maintained in sorted order.

• Added code to verify that OutputPath and WorkingPath do not point to a root or well-known folder (i.e. C:\ or My Documents) to prevent users from accidentally deleting everything in it.

• Support was added for finding <code> tags with closing </code> tags in addition to the self-closing tags for importing code blocks in additional content files.

• Support was added for merging two or more code snippets into a single code example by nesting code tags within a parent code tag. Nested code tags are supported in XML comments and additional content files.

• The code colorizer was updated to be more flexible in matching language IDs to rule sets. It will now match the ID case-insensitively to the ID or friendly name. It will also match several common variations to the correct rule sets (i.e. VB to VB.NET, CSharp to C#, etc.).

• Added a ShowMissingNamespaces project option so that "missing namespace comments" messages in the help file can be suppressed if not wanted.

• The website output option has been modified. It no longer uses a frame set. Instead, it uses a combination of DIV tags, CSS, JavaScript, and an IFRAME to display the table of contents and the selected page.

• In addition, a couple of ASP.NET pages are supplied that should work more efficiently than the basic Index.html page. The main Index.aspx page only loads the root nodes for the table of contents when first displayed. Ajax calls are used to load child nodes dynamically when they are first expanded (done using FillNode.aspx). A Web.config file is included that contains some necessary namespace declarations for the pages. The pages use inline code so there shouldn't be any need to compile them before deployment.

• When viewing the ASP.NET index page, full-text search is also available. The search results are returned using an Ajax call to the SearchHelp.aspx page. Search results are sorted by rank (most likely match first) by default or they can be sorted by title.

• Expanded the output viewing options to let you choose which format to view when multiple formats have been built. This includes the ASP.NET website option using the .NET 2.0 development web server (IIS not required).

• The Verbose Logging option on the Documentation menu has been removed. There is now a User Preferences option on the Project menu that lets you edit non-project related user preferences such as the verbose logging option, an MS Help 2 viewer application, and the port to use for the ASP.NET development web server used to view website output.

• The output and log viewing options were modified so that you can view the results from a prior session without having to do a build after restarting the help file builder.

• Added some more common problems and solutions to the FAQ.

• Localized versions of the shared content files were removed. See the 1.6.0.0 release notes for the reasons and information on the new implementation.

Other Resources