|
Version 3.5
(12. May 2008)
- NEW: Enum items can be sorted by name, value or unsorted. (No GUI option yet. You need to manually edit .vsdoc file.)
- CHANGE: The comment editor generates the top level XML comment tags - <summary>, <remarks>, <returns>, <value> and <example> on separate lines instead of on one line.
- CHANGE: When reading top level XML comment tags (e.g. <summary> or <remarks>), all leading and trailing whitespaces in tag value are ignored now.
- CHANGE: Member chapters in RTF output have different styles now (Heading 1-4). This allows better customization, e.g. numbering, custom structured TOC, etc.
- FIX: VSdocman wasn't present in VS 2008 sometimes if both VS 2005 and VS 2008 were installed.
- FIX: The help2_msdn2 output works with both VS 2005 and VS 2008 MSDN now.
- FIX: When generating documentation using "Compile Solution to Single Documentation", some projects didn't appear in the table of contents. They were only visible in Index.
- FIX: In Web Site projects (not Web Application projects), there was no syntax section generated for methods.
- FIX: In Web Site projects (not Web Application projects), compilation was aborted with "Unspecified error" if project contained overloaded methods.
- FIX: In Web Site projects (not Web Application projects), also aspx files appeared randomly in the files list in Compile - Files options.
- FIX: Sometimes, "Error reading file." error occurred in command line compilation and compilation didn't finish.
- FIX: In VB 2005, not all overloaded properties were included in documentation.
- FIX: Comment editor inserted <returns> instead of <value> tag for properties.
- FIX: Pictures included with <img> tag were not visible in RTF output.
- FIX: The WYSIWYG comment editor appended random character to each picture, if that picture was followed by character other than white-space.
- FIX: Occasional crash during compilation, especially with large solutions.
Version 3.4.2970
(19. February 2008)
- NEW: The "Select link" dialog in comment editor allows selecting the members in referenced libraries (e.g. .NET classes) also in VS .NET 2002 and 2003.
- CHANGE: The "ParamArray, comma-delimited list of values." text is no longer automatically prepended to description of parameters defined with ParamArray in VB or params in C#.
- CHANGE: The "Optional", "Required" and "The default value is " texts are automatically prepended to optional parameter description only when parameter description is empty. (VB only).
- CHANGE: The links to referenced members that are not part of .NET framework (e.g. third-party controls) are correctly generated too. There's a chance that the target help topic will be found.
- FIX: Inserting images in comment editor didn't work on Windows Vista.
- FIX: Sometimes, the command line build exited with error code 3 without generating documentation.
- FIX: Comment editor generates correct cref link for generic constructed types and for arguments whose types are type parameters. The same applies to generated XML doc file. For example a method with full name
Class1<T1, T2>.Method1<T3>(List<int> x, T2 y, T3 z) in C# or
Class1(Of T1, T2).Method1(Of T3)(ByVal x As List(Of Integer), ByVal y As T2, ByVal z As T3) in VB
should have the following cref link:
M:Class1`2.Method1`1(System.Collections.Generic.List{System.Int32},`1,``0).
- FIX: Methods in C# with no comment didn't inherit comment from overridden method.
- FIX: The member's parent class name was not listed in See Also section of documentation generated with VS .NET 2002/2003.
- FIX: Wrong resizing of compilation progress dialog.
Version 3.4.2942
(21. January 2008)
- CHANGE: In Compile - Files options, the files are now shown as a tree for better navigation.You can easily select/deselect whole folder now.
- FIX: New solution or project profile couldn't be created. This problem appeared only in version 3.4.
- FIX: Wrong indexing of the title page for full-text search in HTML output format.
Version 3.4
(8. January 2008)
- NEW: Visual Studio 2008 support.
- NEW: Added full-text search functionality in HTML output. Moreover, table of contents and index are no longer implemented as Java applets. Everything is implemented in HTML and JavaScript. This resolves security problems on intranets, various Java related issues and better indexing by search engines.
- NEW: The "Select link" dialog in comment editor allows selecting also the members in referenced libraries (e.g. .NET classes) in VS 2005.
- CHANGE: Compiling web site and web application projects is faster.
- CHANGE: The compilation window is more responsive. You can cancel the compilation immediately at any time.
- CHANGE: The "Optional", "Required" and "The default value is " texts are automatically prepended to parameter description only when there is at least one optional parameter (it happens in VB only). Moreover, these texts are localized now.
- CHANGE: Removed "Members" sub-page under namespaces in TOC. This page is not needed because all namespace members are listed on namespace main page.
- CHANGE: Empty namespaces are not included in documentation.
- FIX: Passing "/vs 2005" parameter to VSdocmanCmdLine.exe caused an error message.
- FIX: Using "/compileProject" operation in VSdocmanCmdLine.exe sometimes processed random project from the solution instead of specified project.
- FIX: The Help2 documentation was not registered correctly on some computers. There was no table of contents shown for generated documentation, only Index and Search worked fine.
- FIX: Small problems in WYSIWYG comment editor - multiple lines with formatting (e.g. bold) inside <code> tags were joined together when opened in editor again, incorrect selecting/unselecting text with Shift + down arrow, improved undo operation.
- FIX: When declaring some member as generic type with particular type argument, the declaration in the help didn't contain two links - one to generic type and one to type argument. For example "public ICollection<MyClass> test;" in C# or "Public test as ICollection(Of MyClass)" in VB should contain links to ICollection and to MyClass.
- FIX: Complex constant and enum values in C# (hex, containing +-/* or comment) are now calculated and correctly shown in all language syntax sections.
- FIX: Wrong syntax was generated for classes that inherited from generic classes in C#, e.g. public class MyClass : List<int>.
- FIX: Wrong syntax was generated for properties with different accessibilities for getter and setter part (.NET 2.0 and higher).
- FIX: Compiling large web site or web application projects (more than 1000 code files) caused VS crash.
Version 3.3
(17. July 2007)
- NEW: Added profiles. You can now save your settings under custom profiles and easily generate different documentation for the same project. You can also exclude specific projects when compiling documentation for whole solution.
- NEW: Added pt-Pt (Portuguese) output localization.
- CHANGE: Enhanced command line functionality. The VS IDE is no longer shown, the messages are written directly to console standard output and added support for profiles.
- CHANGE: Removed Save/Load default settings functionality.
- CHANGE: Modified help2_msdn2, html_msdn2, chm_msdn2 and rtf outputs. When compiling the solution to single documentation, the help title, header and file names are based on solution name and not on the current project name. Moreover, the Help2 output no longer contains unnecessary extra root node.
- CHANGE: Launching of VSdocman on web projects in VS 2005 works much faster now.
- FIX: When "Public" was not selected for compilation in VSdocman options, explicitly defined namespaces and their contents were not included in documentation.
- FIX: In web site projects in VS 2005, the source files in subfolders were ignored.
- FIX: In Web Application projects in VS 2005 (not web sites), the code behind files of the forms were ignored.
- FIX: If the solution contained SQL Server 2000 Reporting Services project, the "Compile Solution" and "Compile Solution to One Documentation " buttons were not available.
- FIX: When Pretty file names were selected in Output - File Names options, constructors were not listed in documentation.
- FIX: The C# source code is no longer marked as Visual Basic in some output formats. The language of the source code is shown correctly for VB .NET and C#.
- FIX: The blank lines in source code and code examples were removed in HTML based documentation.
- FIX: The user defined Platforms text was ignored in some output formats.
- FIX: The "Copy Code" button above the code section is fixed in chm_msdn2 and html_msdn2 output.
- FIX: The inheritance tree was not shown for some classes and some links to framework classes didn't work as well.
- FIX: The class declaration was handled incorrectly if it contained conditional compilation directives (e.g. #if).
- FIX: Sometimes the comment editor (when set as modal) was hidden behind VS window.
- FIX: In comment editor, when the last text in table cell was code or link, the XML comment for the table was generated incorrectly.
- FIX: Installation error on Windows Vista.
Version 3.2
(24. January 2007)
- NEW: You can select for which languages VSdocman generates syntax -
VB .NET, C#, C++ and JScript.
-
NEW: You can define platforms and supported frameworks.
-
NEW: User is warned if he tries to insert picture from outside of external
files folder or if external files folder is not defined.
-
CHANGE: Adding or editing XML comments in large files works faster now.
-
CHANGE: Main VSdocman window stays open for further work after compiling
documentation.
-
CHANGE: Improved RTF output. Added page numbers in TOC and index. Removed
duplicate namespaces when compiling solution to single documentation.
-
CHANGE: Generated help page for the namespace doesn't contain declaration
section anymore.
-
FIX: Sometimes the "Select reference" dialog didn't show all namespaces in the
project.
-
FIX: When using help2_msdn2 output format, the topics were shown incorrectly if
MSDN for VS2005 was uninstalled (replaced by full MSDN).
-
FIX: VSdocman locked if there were /* ... */ comments inside attribute.
-
FIX: In VS 2005, when documenting whole solution, the projects in solution
folders were not included.
-
FIX: In some rare cases, the "Dead link..." warnings appeared when there were
no dead links at all.
-
FIX: No "S" icon in class list and no "static" keyword in C# declaration for C#
static classes in VS 2005.
-
FIX: There was no link to parent class in See Also section of class members if
the class was generic and written in C#.
-
FIX: Wrong syntax of array parameters in C# methods was used in VB .NET
declaration. The [] was used instead of ().
-
FIX: Namespaces were sometimes listed with full name and sometimes with short
name. They are always listed with full name now.
Version 3.1
(8.
November 2006)
- Comment editor doesn't wrap the text
inside <code> and <c> tags when writing comments back to
source code.
- Warning is shown when VSdocman cannot save its
settings due to insufficient write permissions or file is read-only
(because it is checked-in to SourceSafe).
- FIX: Problems with
generating the output for C# projects with generic members. The <
and > characters in member name caused problems in HTML or XML based
output formats.
- FIX: Pasting of formatted text didn't work in
WYSIWYG comment editor in VS 2005.
- FIX: In some special cases,
the XML comment was placed at incorrect place in C# source code in VS
2005.
- FIX: Wrong section name for method return value in RTF
output.
Version 3.0 (VBdocman .NET
renamed to VSdocman)
(6. September 2006)
- Added
full C# support. The program
now supports VB .NET and C#. That's why it is renamed from VBdocman
.NET to VSdocman.
- Localized output in several
languages including English, German, French, Spanish and Slovak. Adding
new language is just matter of editing one text file.
- All links
(<see>, <seealso>, inheritance tree, types in declaration)
can point to framework members now.
- Member declaration is shown
also in C#, C++ and JScript syntax
and types inside are shown as links.
- Added ability not to list
member attributes in declaration syntax section (Miscellanous - Source
Code settings).
- Inheritance tree shows all superclasses, even
those outside the project, e.g. framework classes.
- Public
variables in the class are no longer listed as properties. They are
listed as fields now.
- Members on "Members" page are grouped and
marked by accesibility (public, protected, ...). Static members have
"static" icon.
- Improved HTML output for even better
cross-browser compatibility.
- Significantly improved performance speed.
- FIX:
Comment editor was not displayed on computers with "Large Fonts" set.
- FIX:
Problems with compilation of Declares in VS 2005.
- FIX: Problems
with compilation of Events in VS 2005.
- FIX: Problems in WYSIWYG
comment editor: pasting multiple times, deleting text selection deleted
also next character, inserting new section (e.g. Example) while text
block was selected.
- FIX: Problems with remembering which files
go to compilation.
- FIX: Incorrect values of enumeration
constants that were not explicitly initialized.
Version
2.3
(10. February 2006)
- Added support for
generics in VS 2005. New <typeparam>
tag introduced.
- Improved support for partial classes
and structures in VS 2005.
- Added support for <System.ComponentModel.Description
...> attribute. You can easily insert <Description...>
attribute from context menu. If you add new comment, default summary is
automatically extracted from <Description...> attribute if any.
-
Comment editor now remembers whether it is in WYSIWYG mode and its size
and position.
- Removed editing of parameter
settings from comment editor because parameter
settings represent old practice from VB6 and you should use
enumerations instead. VBdocman however still recognizes <set> and
@set tags in the comments.
- FIX: <returns> tag is not
added by "Add XML Comment" for Subs.
- FIX: VBdocman didn't
work with Web projects in VS 2005 .
- FIX: When
using Compile Solution or Compile
Solution to One Documentation, some projects may have empty
documentation.
- FIX: Compiling help for Smart Device
projects didn't work.
- FIX: Command
"VBdocmanNET.Connect.CompileSolutionToOne" didn't work from command
line.
- FIX: Wrong adding and reading of comments in VS 2005
when member has attribute.
Version 2.2
(30.
November 2005)
- Added support for VS 2005. Generics are
not supported yet.
- Added support for smart device projects.
- VBdocman
now produces and recognizes C# XML links in cref attributes. Type
character is prefixed, e.g. M: or T:, [] are used instead of () for
array parameters, @ is appended to ByRef parameters and there are no
spaces between parameters. This is needed for good compatibility with
VS 2005.
- Help 2 documentation can be viewed with full
formatting immediately after generation.
- Context menus are only
visible on VB and macro files.
- "Compile to One Solution" button
is disabled when there's only one project in the solution.
- FIXED:
When there was an option checked to generate IntelliSense XML file,
some formatting tags (<c>, <see>, ...) in <summary>
and <param> tags were ignored in resulting documentation.
- FIXED:
Problem with the tabs (scrolling) in Comment Editor.
Version
2.1
(19. April 2005)
- Fixed bug that caused problems with setting a list of .vb files
that are to be documented. This problem especially occured when
updating your project from VBdocman .NET version 1.x to version 2.0.
Version 2.0
(21. February 2005)
-
New formatting and objects added to comments - bold, italic,
underline, text color, links,
bulleted or numbered lists, tables
and pictures.
- Support for more XML
documentation tags added - <list>, <para>,
<see> and <value>.
- Comment editor is WYSIWYG. Only XML
comments are generated by editor but VBdocman still recognizes also
@-style comments.
- Comment editor can be
also modeless, floating and dockable.
- <value> tag
replaces <returns> tag in properties. <returns> tag is
still valid in property.
- You can specify folder with
your own external files now. All external files will
be automatically included in documentation and you can reference them
from your comments e.g. in <see> or <img> tags.
-
Added possibility to comment root namespace.
-
In addition to random numeric names, generated files can have also pretty
and constant names based on member name. So you can easily
reference them from outside.
- You can
generate ONE documentation for whole solution .
Namespaces and members are merged into one TOC.
- You can
assign keyboard shortcuts to VBdocman actions. Go to
Tools | Options... | Environment | Keyboard and look for the following
commands: VBdocmanNET.Connect.CommentEditorShortcut,
VBdocmanNET.Connect.AddCommentShortcut and
VBdocmanNET.Connect.OpenMainVbdocmanWindowShortcut.
- Preview
of Help 2 documentation can be seen immediately after it
is generated, without restarting VS.
- VBdocman project settings
are stored in separate .vbdoc file instead of .vbproj file.
This avoids conflicts when using version control systems (SourceSafe)
or automated builds. Old settings stored in .vbproj files are still
valid if no .vbdoc file exists.
- Documentation now indicates
if a member has ObsoleteAttribute or FlagsAttribute
applied.
- Newly added project item is
automatically included in VBdocman's Compile | Files
list.
- Undo operation after inserting
comment by comment editor is improved. You don't need to perform Undo
several times to get original state.
- Inheriting of XML
comments is fixed.
- Paths (e.g. output path) may contain
foreign non-English characters now.
- Fixed problem with
attributes in declarations on overloads list page.
- Problem
with saving of title text. Newlines were removed from title text after
reloading VS. Fixed.
- Missing spaces between words in
RTF output when comment is on multiple lines. Fixed.
- Fixed
commenting of namespaces when one namespace was specified in multiple
files. Now you only need to comment the namespace in
one file.
Version 1.3
(24.
October 2004)
- Fixed problems with links to external
files. There is new prefix ^ for link to external files in addition to
" prefix.
Version 1.2
(25. May
2004)
- Command line functionality added.
- Conditional
compilation of individual members added. You can select for each member
if it will be compiled.
- HTML output has now modern look,
fixed scroll bars in table of contents and pages have MSDN style also
in non IE browsers.
- References in XML comments that were
broken to several lines are processed correctly now.
- Comment
editor doesn't wrap references in @-style comments so that they be
processes correctly.
- Fixed some problems when editing
parameter settings in comment editor.
- Fixed parsing of
constant value in @set tag if it was string with spaces.
- Fixed
parsing of references in @-style comments if references contain spaces
(functions with several parameters delimited with comma and space).
- Fixed functionality of "Find interesting links" button in comment
editor in VS .NET 2003.
- @includesource tag always returned
non empty value even if there was no value. Fixed.
Version
1.1.1495
(9. February 2004)
- Auto-find
button added to atomatically find hxcomp.exe anytime.
- Fixed
problem when not all source files in the project were recognized. This
happened when they had same names but were in different folders.
Version 1.1
(15. January 2004)
-
Non-english character sets supported.
- Non-english Visual
Studio .NET supported.
- Ability to remove line continuations
in source code listings in documentation.
- Compilation
progress dialog can be resized to better reading of messages.
- Some
macros added to templates to allow translation of templates to other
languages.
- Some problems with unrecognized comments fixed.
- Behavior of Apply button in Comment Editor fixed.
- $CHRn$
macro processing fixed.
- When using XML comments, <, >,
&, ' and " characters are escaped automatically in the background
within $CODE$ block.
- Processing of names of overloaded
members is not case-sensitive now.
- Fixed problems with
enumeration constants in VS 2003.
Version 1.0
(2. October 2003)
|