| Version 1.5.0.0 |
Version 1.5.0.0 was released on June 25th, 2007.
Changes in This Release - 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. See the
Code Block Component topic and
Importing and Colorizing Code from Source Files topic for details.
- 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.
See Also