VSdocman
See also more recent release notes.
Version 7.6
(8 Oct 2016)
- NEW: Added the option to display namespaces with their short names (just the last name part) in the TOC and "Namespaces" table. By default they are listed with their full names. You can now suppress it with the setting in the project properties, not accessible from GUI. Just open .vsdoc file for the project or solution and change the value of the "VBdocman_ListNamespacesWithShortNames" key from 0 to -1.
- CHANGE: Improved the startup time of any initial operation with VSdocman (open VSdocman, Add comment, open comment editor, ...) in a large VS solution with a large number of projects.
- FIX: Improved inheriting of comments from implemented methods in an implemented interface.
- FIX: Explicit <see> links to members that were not explicitly declared in the code, but only inherited, were not generated correctly. An example of such link could be the <see cref="MyClass.ToString"/> link which should point to Object.ToString.
- FIX: If the cref attribute in the <exception>, <seealso> and <permission> comment tags didn't contain a full name (e.g. shortened Exception instead of System.Exception), an incorrect link was generated.
- FIX: The WYSIWYG comment editor generated incorrect color value when you selected a text color. If you selected a named color, the color name was generated instead of expected hex value. For example color="red" instead of color="#FF0000". Such colors were ignored in generated documentation.
- FIX: Code attributes were taken only from a single partial declaration of a class, interface or structure. If there were other attributes specified in other partial declarations, they were ignored. This way, for example, the ObsoleteAttribute could be ignored in partial classes.
- FIX: If a project was removed or renamed in VS solution, and then you made any changes in VSdocman's Profile Manager, these changes were not saved.
- FIX: In very rare cases, the command line utility VSdocmanCmdLine.exe could exit with the error code 1 (Visual Studio was not found.) with the additional exception info: COMException (0x80080005). This is usually caused by a temporary high CPU or memory load. Everything usually works on the next execution. So we added the new optional /retryOnCpuBusy COUNT;INTERVAL parameter for the VSdocmanCmdLine.exe which allows you to automatically retry the operation in this situation.
Version 7.5
(23 May 2016)
- CHANGE: The Profile manager window is resizable now. It's useful when you have a large solution with many projects.
- FIX: Improved font and size scaling of some VSdocman windows on high DPI screens.
- FIX: Reloading of a project or a solution file in Visual Studio (e.g. csproj, vbproj, sln) could prevent VSdocman from correctly reading the project properties. Visual Studio restart was required. The reloading usually happens after updating from source code control or when a file was modified outside of Visual Studio.
- FIX: Sometimes, changes in project properties were not saved, especially when dealing with multiple settings profiles. Pressing the OK button in the VSdocman window did nothing.
- FIX: Wrong display of warnings in some cases. For example, false "dead link" warnings could appear if conditional compilation of documentation was active. Or some "dead link" warnings were not displayed in very rare cases.
Version 7.4
(20 Mar 2016)
- FIX: Generic interfaces and delegates with covariant and contravariant type parameters were handled incorrectly. Such type parameters are defined with "in" or "out" keywords. For example, "interface IVariant<out T1, in T2>" in C# or "Interface IVariant(Of Out T1, In T2)" in VB .NET. VSdocman generated incorrect XML comments and created wrong documentation for these interfaces and delegates.
- FIX: Some changes in a project or a solution were occasionally not reflected by VSdocman, only after Visual Studio restart. For example, if you added a project into a solution, VSdocman didn't compile documentation for it - it did nothing. Or if you added a reference to a project, it was not used to generate the correct links in the documentation.
- FIX: If a project contained references to .winmd files, the references were ignored. Such references are typical e.g. for Universal Windows projects, where they are used via NuGet packages and SDK references. The issue caused that links to Windows Runtime classes (e.g. Windows.UI.Xaml.Controls.Page) didn't work, members and comments were not inherited from them and the inheritance hierarchy was incomplete.
- FIX: If a project didn't contain references to the framework assemblies (e.g. mscorlib) directly, but via NuGet package (e.g. Universal Windows projects), VSdocman couldn't retrieve XML comments from such assemblies. The issue caused that some comments couldn't be inherited or that summaries of some inherited methods (e.g. ReferenceEquals) were not shown.
- FIX: In some very rare cases, when compiling from command line, the VSdocmanCmdLine.exe process was not closed after successful compilation.
Version 7.3
(9 Jan 2016)
- NEW: Added complete traditional Chinese translation for generated documentation. Just select zh-TW as the language in the output options.
- NEW: You can specify topics version for the MS Help Viewer format. See VSdocman's help, Viewing and Deploying Documentation - View and Deploy MS Help Viewer Documentation - Topic Versions in MS Help Viewer Documentation page.
- CHANGE: In web site projects without a project file (not web applications), the $(ProjectDir) macro in the output options has a different value. Previously it was the directory constructed from <SOLUTION_FOLDER>\<WEBSITE_NAME>. Now it points just to <SOLUTION_FOLDER>. So if you have a web site (not a web application with a project file) and you specified the Output folder as $(ProjectDir)VSdoc, you need to change it to $(ProjectDir)<WEBSITE_NAME>\VSdoc, where <WEBSITE_NAME> is the name of your web site project.
- FIX: The links that contained an ampersand (e.g. <see href="http://www.helixoft.com/index?x=1&y=2"/>) were generated incorrectly.
- FIX: The link to the parent namespace was not generated in a code member topic, if the namespace was a root namespace in the project.
- FIX: In VB .NET, external methods defined with DllImport attribute instead of Declare statement were not recognized as external.
- FIX: Links to external methods (defined with DllImport attribute) were not generated correctly.
- FIX: If an event in VB .NET was defined with an explicit generic delegate, e.g. Public Event TextChanged As EventHandler(Of TextChangedEventArgs), the syntax section in documentation was generated incorrectly.
- FIX: If a method in a class implemented a method in an interface, the comment for a method was incorrectly inherited if the interface contained multiple method overloads, i.e. methods with the same name but different parameters. This happened when you for example clicked "Add XML comment" for the method in the class.
- FIX: The blank lines inside a <code> tag that were inserted in the comment editor were not included in the XML comment.
Version 7.2
(29 Jul 2015)
- NEW: Added support for new ASP .NET 5 web applications (*.xproj) in VS 2015.
- FIX: Namespaces were incorrectly shown at the top TOC level in generated MS Help Viewer format. The problem occurred only in 7.x versions.
- FIX: The comment editor produced a damaged comment if it contained a <seealso> tag with a text containing < > & characters. The same applied to <exception> and <permission> tags if they contained these characters in their cref attribute. Now the characters are correctly escaped with < > & and no failure occurs.
- FIX: If you selected the text that contained < > & characters in the comment editor and applied inline code style to it (<c> tag), these characters were removed.
- FIX: Dead links are no longer displayed as an error text in Docx output format.
Version 7.1
(12 Feb 2015)
- NEW: Statistics of compiled topics (classes, methods, ...) is displayed when the compilation is finished.
- NEW: Added complete Chinese translation for generated documentation. Just select zh-CN as the language in the output options.
- NEW: You can specify the following additional frameworks to be listed as supported: .NET Framework Client Profile, Portable Class Library, .NET for Windows Store apps and Others.
- CHANGE: The CHM compiler that is used for compiling to CHM format is no longer bundled with VSdocman installer. The utility is a part of free HTML Help Workshop from Microsoft that you need to download and install. There's a chance that it is already installed on your system. Check your VSdocman Options - Miscellanous - Environment page.
- CHANGE: Improved Help&Manual output. Generated H&M project contained a lot of conditional text, especially due to HxS links. This caused very slow loading and compilation. Since HxS (VS 2005/2008 help format) is no longer used as a common format, all HxS links were converted to web links and the conditional text was removed. This means that, for example, in HxS documentation, the link to System.String now points to online MSDN instead of local MSDN. Large H&M projects are much more reliable now.
- FIX: When the documentation title contained some Unicode characters (e.g. Chinese), then CHM compilation could fail on some systems, probably those with non-English OS.
Version 7.0
(4 Nov 2014)
- NEW: Support for VS 2015 and VS 2015 help system.
- NEW: You can easily copy project properties from one project to other projects. There's a new "Copy" button on the left panel of the VSdocman project properties window. You can select which properties will be copied and to which project(s).
- NEW: Solution-wide common properties. They are used when you execute "Compile Solution to Single Documentation". They are saved inside a solution profile. You can edit them by clicking on the project name at the top of Project Properties in VSdocman and select SOLUTION-WIDE PROPERTIES.
- NEW: You can create and edit XML comments even in a shared project (.shproj), for example in Universal Apps.
- NEW: Enabled Ctrl+A in "Edit custom topic source" window and in "View source" tab in the comment editor.
- CHANGE: The concept of a "base project" when executing "Compile Solution to Single Documentation" is no longer used. The solution-wide common properties are used instead. You can select which common properties will override the properties from individual projects. This allows you for better flexibility. As a consequence, the /baseProject parameter is no longer supported in command line mode. If you already used "base project" before, you can easily copy its properties to the solution-wide common properties. In VS, select the project that served as the base project. Open VSdocman window and select Project Properties. Click the 'Copy' button on the left side and copy desired properties from the project to SOLUTION-WIDE PROPERTIES.
- FIX: F1 didn't work for constructors in VS 2010/2012/2013 help. Moreover, links pointing to external URLs (e.g. http) in VS 2012 and 2013 help didn't work.
- FIX: The <font> XML comment tag didn't change a text color in VS 2010/2012/2013 help.
- FIX: When the command line utility VSdocmanCmdLine.exe was executed with VS 2013 to compile a documentation for a project, then wrong project from the same solution could be compiled instead of the specified one.
- FIX: Occasional problems with class diagrams (warnings and diagrams not generated) when executing "Compile Solution to Single Documentation".
- FIX: If a code member or a topic had a link with an empty cref attribute in its XML comment, then some other links in the comment could be generated as an empty text.
- FIX: In website projects, sometimes the files in Project Properties - Code Members - Files were not grouped into folders.
Version 6.8
(6 May 2014)
- CHANGE: Removed the following settings for modeless comment editor: "Tool window", "Dockable" and "Tabbed document window". They were redundant and the window can be customized directly in the IDE as other VS tool windows, e.g. Solution Explorer.
- FIX: When a C# interface or a structure had an attribute with text that contained ":" character, then inherited/implemented interfaces were listed incorrectly in the generated Syntax section.
- FIX: When creating a new comment with 'Add XML Comment' or 'Comment Editor', a default comment was not inherited from an overridden/implemented member in a current project. The comment inheriting worked fine when the comment came from a referenced assembly (i.e. not from a project member) or when it was done automatically during documentation compilation.
- FIX: When modeless comment editor toolwindow was closed and the "Automatically apply changes ..." option was selected, the comment changes were not applied sometimes.
- FIX: When an URL in href attribute of <see> or <seealso> XML comment tag contained a space character, the space was removed in generated link.
- FIX: Sometimes, MS Word reported an error in generated docx file and you needed to repair it. This happened when: A) There was an image with the space character or any non-ASCII character in its filename. B) There were files in your "external files folder" that were not actually used.
- FIX: When some third-party designer was opened in VS (for example DevExpress XAF Model Editor), then when you tried to open VSdocman for the first time, the licensing error dialog appeared.
Version 6.7
(14. Mar 2014)
- NEW: Added additional keyboard shortcuts for cut, copy and paste - Shift+Del, Ctrl+Ins and Shift+Ins in WYSIWYG comment editor.
- CHANGE: Improved Help&Manual output for the latest H&M versions (show TOC when particular topic is loaded with direct URL, fixed newlines in code examples).
- CHANGE: Improved performance of comment editing in some projects that reference many third-party assemblies.
- FIX: Sometimes, a missing comment was not inherited from overridden/implemented member in a referenced third-party assembly.
- FIX: When IE 10 or higher was installed, double/triple-click didn't select whole word/sentence in WYSIWYG comment editor. Moreover, the word selection is improved now, it works as in VS editor. A word can contain an underscore '_' character and it doesn't contain a trailing space.
- FIX: In very rare cases, when you clicked inside WYSIWYG comment editor, the caret was set to a wrong position.
- FIX: In WYSIWYG comment editor, when a text selection contained a text of various colors, it was impossible to change its properties, e.g. change it to a bulleted list.
- FIX: Application could crash when pasting a text copied from MS Word (and maybe some other applications too) into WYSIWYG comment editor.
- FIX: The language selected by a user in local HTML documentation was not retained in Chrome browser. Moreover, the default selected language is C# and not VB now. This can be changed in a generated config file.
- FIX: In docx output, multiple sub-classes were indented incorrectly in the Inheritance Hierarchy.
- FIX: The Inheritance Hierarchy was not generated for some classes in some cases.
Version 6.6
(20. Jan 2014)
- FIX: The WYSIWYG comment editor was incorrectly wrapping lines for C# and VB examples inside <code lang="C#"> and <code lang="VB"> comment tags. Only generic code inside <code> was handled correctly and it was not wrapped.
- FIX: Copy&paste in the WYSIWYG comment editor didn't work in Visual Studio 2013 running on 64-bit operating system.
- FIX: In the WYSIWYG comment editor, pasting of non-ASCII text (e.g. diacritics, Chinese, ...) in HTML format (e.g. copied from IE or from the editor) didn't work correctly. This only happened when VSdocman was running on .NET 4.5, that means in VS 2013, 2012 and possibly also in VS 2010.
- FIX: After generating the documentation in MS Help Viewer format (VS 2010-2013 help), the documentation was not automatically registered. The problem was only present in version 6.5.
- FIX: Handling of some generic types. If, for example, a class inherited from a constructed generic type whose type argument was also a generic type (e.g. class TestClass1<T> : List<List<T>>), the links in syntax section were generated incorrectly. If the type argument was not generic (e.g. class TestClass1<T> : List<T>), it worked OK.
- FIX: In the Inheritance Hierarchy, external superclasses (e.g. System.Object) were not shown correctly. This problem was present in versions 6.3 and higher.
Version 6.5
(2. Nov 2013)
- NEW: Support for VS 2013 and VS 2013 help system.
- CHANGE: In chm_msdn10_lightweight and html_msdn10_lightweight output formats, the language tabs for unavailable languages in code examples are not visible anymore.
- FIX: Overloaded external methods (defined as extern in C# or as Declare in VB) were not shown correctly in generated documentation.
Version 6.4.4996
(9. Sep 2013)
- FIX: In VS 2012 C# code, a link to a type in the same project/solution but in a different namespace wasn't correctly resolved because 'using' statements were ignored. This worked correctly in other versions of Visual Studio.
Version 6.4
(16. Aug 2013)
- NEW: Automatically update content of the comment editor (opened as modeless window) as you go through your source code. You don't need to click on the editor to see the comments of the current code element. This may slow down the IDE. You can turn on or off this feature in Options > Comment Editor > Editor Window.
- NEW: Improved functionality of user tags. In addition to a tag name and its generated section heading, you can now define also a default text that will be placed in documentation if the tag in your XML comment is empty.
- CHANGE: When the cursor is inside XML doc comments, starting the comment editor or adding an XML comment will be executed for a code element to which the XML comment belongs, e.g. a method. Previously it was a containing parent type, such as a class or a namespace.
- CHANGE: If the summary section in the comment editor is empty, than an empty <summary></summary> comment block is not generated anymore.
- FIX: If method parameters were decorated with attributes, the attributes were not shown or the parameters were shown incorrectly in generated Syntax section.
- FIX: If you selected install for "Everyone" and not for "Just Me" during VSdocman installation, this option was ignored and VSdocman was installed just for current user. This caused problems especially for automated command line builds, because they are usually executed under different user. This issue was present only in versions 6.2 and 6.3.
- FIX: Sometimes, the WYSIWYG comment editor, when opened as modeless window, didn't show code element's comment and stayed empty.
- FIX: When the command line utility VSdocmanCmdLine.exe was stopped prematurely (with console close button, CTRL+C, process kill...), an orphaned devenv.exe process might be left unterminated.
- FIX: When generated HTML documentation was stored on a web server and it was viewed with Chrome, then the TOC was always collapsed when different topic was selected.
Version 6.3.4857
(19. Apr 2013)
- FIX: When no C# or VB project was loaded or selected in the Solution Explorer, then starting VSdocman from the toolbar or Tools > VSdocman menu did nothing. Main VSdocman window that allows editing only global preferences should be opened. This problem only appeared in version 6.3.
Version 6.3
(4. Apr 2013)
- NEW: Added new <br/> XML comment tag which lets you insert a newline. Unlike the <para> tag, it doesn't create a new paragraph. You can press SHIFT+ENTER in comment editor to insert this linebreak.
- NEW: Output messages and warnings during compilation are logged also in VS Output window and Error List (as clickable warnings). The same applies when compiling the documentation from command line, for example, in post-build event.
- NEW: Added the option not to sort See Also links. By default they are sorted alphabetically. You can now suppress it with setting in project properties, not accessible from GUI. Just open .vsdoc file for the project and change value of "VBdocman_dontSortSeeAlsoList" key from 0 to -1.
- CHANGE: New code files added to a project are automatically included for compilation even if VSdocman isn't launched when the files were added. And it automatically works for all profiles, not just the current one. This is caused by the fact that VSdocman now saves explicitly excluded files instead of included files. To apply this change, you need to re-save project properties. Just open VSdocman main window for a project (switch to each profile if any) and press OK.
- CHANGE: Better responsiveness for large web site (not web application) projects.
- CHANGE: In HTML output formats, the links to external URLs, defined with <see href=...>, will open in the top window instead of the right frame.
- FIX: Linked (included with Add as link) *.designer.cs/vb files were incorrectly listed in Project Properties - Code Members - Files.
- FIX: Sometimes, usually when IE 10 was installed, an existing link couldn't be edited in WYSIWYG comment editor.
- FIX: Adding a See Also link in WYSIWYG comment editor didn't work correctly.
Version 6.2
(26. Feb 2013)
- NEW: Added docx output file format. Now you can generate docx document in OOXML format compatible with MS Word 2007 and higher. You can later edit, print and convert it to PDF.
- CHANGE: Conditional compilation and regex filters are applied also to a list of members now. For example, if you override ToString method and exclude it from compilation with <compilewhen>never</compilewhen> the topic for that method will not be generated. But the inherited Object.ToString method was still listed in Members and Methods lists. This has now changed and the Object.ToString method isn't listed at all. The same applies to regex filters.
- FIX: In VB 2012, it is possible to omit the ByVal keyword for a parameter passed by value. VSdocman generated incorrect declaration as ByRef in that case.
- FIX: When compiling from command line with /operation compileSolutionToSingle, the compilation failed in the second pass. This problem only appeared in version 6.1.
- FIX: Comment editor inserted incorrect relative path to the XML file (one folder higher) in <include ...> comment tag.
- FIX: A dead link was generated if a <see> link to an enum was not specified with a full enum name (with the namespace).
- FIX: A random file named "NULL" could be created in the current directory when generating "MS Help Viewer" format.
Version 6.1
(6. Dec 2012)
- NEW: You can switch edited or compiled project directly in the main VSdocman window. There's a new drop-down button next to the project name. You no longer need to close the window and switch the project in Solution explorer.
- NEW: Added new <threadsafety> XML comment tag which lets you describe thread safety of a class or structure.
- NEW: Added new <permission> XML comment tag which lets you document the access of a member.
- NEW: A search box at the top of "Select reference" dialog in comment editor. This allows for quick filtering in a class hierarchy.
- NEW: User gets a warning when the main window is cancelled and there are any unsaved changes.
- CHANGE: In topic titles and Index entries, the parameters of overloaded methods are displayed in a short form instead of a long form. For example, Method1(StringBuilder) instead of Method1(System.Text.StringBuilder).
- CHANGE: Changes to a project profile or preferences in VSdocman window are no longer automatically saved when you press any of the "Compile ..." buttons. You must explicitly press OK button when closing the window.
- CHANGE: Unused F# tabs are removed from syntax declaration and code examples in html_msdn10_lightweight and chm_msdn10_lightweight output formats.
- FIX: Overloaded methods with generic constructed types as parameters were not listed in generated TOC. They were only accessible from Index. For example: method1(List<int> x) and method1(List<string> x).
- FIX: When you opened an existing XML comment with an image in comment editor, the image was not shown.
- FIX: If a user selected a file in a sub-folder of "External files folder" with "Select reference" dialog in comment editor, generated relative path was incorrect.
- FIX: In C#, if an XML comment or code element's attributes or element declaration itself was inside #if ... #endif, then the XML comment was not recognized.
Version 6.0
(4. Oct 2012)
- NEW: Support for VS 2012 and VS 2012 help system.
- NEW: Significantly improved speed and memory consumption.
- NEW: Improved look and behavior of WYSIWYG comment editor. For example, user can select colors for highlighting of editable regions, paste or drag&drop formatted HTML text including images, drag&drop image files, select editor font size and more.
- NEW: Added href attribute to <see> and <seealso> comment tags. This attribute is used for referencing external file or URL and it replaces old cref="^..." syntax. The old syntax is still supported but the comment editor will produce the new href syntax, for example <see href="http://www.helixoft.com">Helixoft</see>. The new href syntax is easier to read and doesn't cause VS warnings.
- NEW: Added support for definition terms in comment editor and generated documentation. A definition term is represented by a <term> XML comment tag inside a <list> tag and it is visually highlighted in documentation.
- NEW: Added $INHERITED-COMMENT-MEMBER-CREF$ macro for comment templates. For currently edited code member, this macro returns cref of the member from which a comment can be inherited. It may be overridden or implemented method, property or event.
- NEW: A list of namespaces is automatically appended to the end of a custom topic which contains namespaces, i.e. it contains namespaces placeholder as a sub-topic.
- NEW: During compilation, VSdocman reports wrong XML comments, i.e. comments that are not well-formed XML.
- CHANGE: No more support for VS .NET 2002 and 2003. VSdocman now supports only VS 2005 and higher.
- CHANGE: Removed old output templates for html, chm and help2 formats that had old VS 2002/2003 look.
- CHANGE: The main window and the "Select reference" dialog in comment editor are resizable now.
- CHANGE: The cref link to a type in the same project/solution but in different namespace doesn't have to be fully qualified anymore. VSdocman resolves the full name with using/Imports statements.
- CHANGE: The comment editor produces short link syntax without the text if possible. For example <see cref="System.String"/> and not <see cref="System.String">String</see>.
- CHANGE: No default comment (based on the comment templates used for commenting) is automatically added to non-commented code elements during compilation. This could cause incomplete text in documentation, for example unfinished "Gets or sets" phrase for properties. Inheriting of missing comments during compilation still works.
- CHANGE: Each topic shows its own unique URL in a browser if you view HTML output formats. This makes it even easier to share the links to particular topics.
- CHANGE: If you wish to distribute your documentation in MS Help Viewer format, you no longer need to edit a real path to helpcontentsetup.msha file in generated register_XY.bat script. The path will be retrieved automatically.
- FIX: A link with Overload: or O: prefix in <seealso> tag pointed to a random overloaded method instead of Overloads page. This worked fine with <see> tag.
- FIX: Links with constructed generic types didn't work, e.g. <see cref="List{String}"/>. Links with normal generic types worked fine, e.g. <see cref="List`1"/>.
- FIX: Sometimes, the link to implemented or inherited interface or class was broken in Syntax section. This could happen if the target (implemented or inherited interface or class) was defined in the same project/solution but in different namespace. Or the target was an external type and VSdocman didn't resolve its full name because sometimes it failed to read the using/Imports statements.
- FIX: In C#, if there were code elements with the same names but different case (e.g. method1 and Method1), only the first one was included in documentation.
- FIX: If there was a file with a space in its name in external files folder (e.g. "my picture.png"), then compiling a CHM format produced HHC5003 error. The reason was that the space was incorrectly escaped by %20 sequence in generated HHP file.
- FIX: If registration name contained Chinese or Arabic characters, the registration failed.
- FIX: Compilation warnings were not displayed when executing VSdocman from command line with VSdocmanCmdLine.exe.
- FIX: Very rarely, "The Visual Studio couldn't be found." error might appear when executing VSdocman from command line with VSdocmanCmdLine.exe.
- FIX: Links in class diagrams didn't work in some recent versions of Firefox.
Version 5.5
(23. Nov 2011)
- NEW: Support for dependency properties and attached properties. See the "Using VSdocman - Tips & Tricks - Documenting Attached Properties" topic in the help for more details.
- NEW: Support for optional parameters in C#.
- CHANGE: Links to external types (e.g. .NET types) no longer need to be fully qualified. So instead of <see cref="System.String" /> you can use <see cref="String" /> or language specific <see cref="string" />.
- CHANGE: Texts in JScript syntax sections are localized now, e.g. "JScript does not support generic types and methods.".
- CHANGE: Constants and variables are no longer separated but grouped together under the "Fields" section in generated TOC.
- CHANGE: When you edit an <include> comment tag in comment editor, the editor automatically includes also the code element's cref prefix (M:, T:, ...) in the path attribute, e.g. <include file="external_comments.xml" path="doc/members/member[@name='M:MyNamespace.MyMethod']/*" />.
- FIX: Overloaded Explicit and Implicit operators in C# 2008 and 2010 were incorrectly identified as Addition operator.
- FIX: Some problems if your VB code contained elements with names enclosed within [ and ]. This is the case if VB code element uses the same name as some VB keyword. For example, if you want a class named Error, you declare it as Class [Error].
- FIX: F1 help for some code elements didn't work in MS Help Viewer (VS 2010) help format.
- FIX: Readonly fields were marked as constants in generated documentation.
- FIX: The text in <seealso> tags was ignored if cref attribute pointed to an external file or URL using cref="^..." syntax. The cref attribute value was displayed instead.
- FIX: The code elements of VB web site project (not web application) were not listed in generated TOC. They were only visible in Index.
Version 5.4
(8. Jun 2011)
- FIX: Correct fonts and sizes according to system settings. Dialogs didn't look good especially on Windows XP with DPI other than default 96.
- FIX: An empty Source code section was generated for VB projects when "Remove line continuations from source code and join split lines" was selected even if source code inclusion was disabled.
- FIX: Random ghost ".vsdoc" files were created when VSdocman was started with no solution loaded in VS.
- FIX: In all html_* output formats, there were no generic parameters shown at class names in a table of contents.
Version 5.3
(17. Feb 2011)
- NEW: Templates for generating HTML and CHM output which looks like the default online MSDN "lightweight" style.
- NEW: Option to delete all files in output folder before compilation. This can be set in Project Properties - Output - General.
- NEW: More details in generated documentation. The parameter type is listed also in its description, not only in syntax section. Added "Implements" section which lists implemented methods/properties.
- CHANGE: When you leave the "Platforms" property empty, then the Platforms section will not be shown in generated documentation at all.
- CHANGE: You no longer need to select also Constants if you want to include enumeration items in generated documentation.
- FIX: Sometimes there was an error when registering the help in MS Help 2 format (HxS files used in VS 2002-2008 help). This happened if a project or solution name contained a dot. Then the generated file names contained more than one dot. This is not allowed. The name is escaped now.
- FIX: The links that pointed to methods with generic parameters were broken in class diagrams.
- FIX: When generating "Pretty file names", the first link in Overload List was not working in HTML-based output formats.
- FIX: Broken formatting in Syntax section and source code listing in MS Help Viewer 1.0 format (VS 2010 help).
- FIX: When you created or switched to a new profile and then edited any custom topic with WYSIWYG editor, then after pressing OK button, all changes in the new profile were saved into previous profile.
Version 5.2
(4. Nov 2010)
- NEW: Missing XML comments are inherited also from implemented members, not only from overridden members.
- NEW: Added new <overloads> comment tag which allows to specify a summary, remarks and examples common to all overloads of a member. This information will appear on the Overloads topic page for the members.
- NEW: You can use the Overload: prefix in cref attribute of a link also for methods in current project. The link will point to overloads list page. Previously, this was only possible in links pointing to external methods (e.g. in .NET framework).
- NEW: You can use shorter O: prefix as an alternative to Overload: prefix in cref attribute of a link.
- NEW: Added Russian ru-RU localization.
- NEW: Added Thai th-TH localization.
- CHANGE: Improved listing of overloaded methods on Members page in MS Help Viewer format.
- CHANGE: By default, it's no longer possible to use macros from output templates directly in XML comments. Macros have the form: $MACRO-NAME$. If you wanted to use $ character, you had to escape it with $$. This is no longer necessary. If you still want to use macros in your comments, which is very unlikely, you can enable them manually in project properties. Just open .vsdoc file for the project and change value of "VBdocman_allowMacrosInComments" key from 0 to -1 (there is no GUI option).
- CHANGE: Significatly increased a speed of documentation compilation for large web site projects, when not all source code files are selected for compilation.
- FIX: When an interface inherited from more than one base interface, then inherited members only from the first base interface were listed. Members from other base interfaces were ignored.
- FIX: When a type implemented a generic interface, then its (and its members') syntax declaration was not generated correctly in some cases.
- FIX: Sometimes there was an error when registering the help in MS Help Viewer format. One case was when the constants were included in a documentation. Another case was, if project or solution name contained a dot. Then the file name of generated OUTPUT_FILE.mshc file contained more than one dot. This is not allowed due to a limitation of MS Help Viewer 1.0 format. The name is escaped now.
- FIX: The <see ...> links pointing to enumeration items caused "Not found" error. Since there is no separate help page for each enumeration item, such link is transformed to plain bold text now.
- FIX: Some incomplete links in the form <see cref="Method(parameters)" /> pointing to method in current class didn't work.
- FIX: Attributes of C# enum items were ignored (e.g. in regex filters).
- FIX: Generating documentation for large web site project (not web application) in VS 2010 caused VSdocman crash.
- FIX: In HTML and CHM documentation format, links to some classes (e.g. Hashtable) in web MSDN documentation didn't work.
- FIX: Links to referenced external types that are not a part of .NET framework (e.g. third-party controls) are no longer generated. Only the plain text is generated now. This feature worked only for methods and properties, not for classes and interfaces. If you still want to generate the links, you can set it manually in project properties. Just open .vsdoc file for the project and change value of "VBdocman_linkForExternalNotInFramework" key from 0 to -1 (there is no GUI option).
- FIX: When generating documentation in HTML format, some files contained the + character. This could cause problems on IIS7 web sites.
- FIX: HelixoftHelpReg.exe and HelixoftHelpRegQ.exe utility didn't register F1 help in CHM format for VS 2008. Other help formats and other VS versions worked fine.
Version 5.1
(17. May 2010)
- NEW: VSdocman now fully supports new MS Help Viewer format used in VS 2010 help.
- NEW: You can use path macros such as $(ProjectDir), $(SolutionDir) and $(VSdocmanDir) for specifying output folder, external files folder and templates folder. For example you can define output folder as $(ProjectDir)..\..\VSdoc. This is useful when sharing .vsdoc project properties in source control system.
- CHANGE: Improved handling of operators. Operators are now listed separately, they have correct syntax in all languages, they use correct cref syntax in links and their pretty file names don't contain forbidden characters.
- CHANGE: Improved saving of a project properties (.vsdoc) file. If the file is under source code control, it is first checked out before saving. The file is now saved less often, only when really necessary. Now, the settings in this file are not ordered randomly so the source code control isn't confused. Moreover, the properties are saved in more readable format for easier conflict resolving with source code control.
- CHANGE: When you add a new file into C# project, the file is automatically added to the list of files to be compiled.
- FIX: VB 2010 introduced implicit line continuation, i.e. in many cases, you can continue a statement on the next consecutive line without using the underscore character " _". Sometimes, VSdocman failed to recognize or insert XML comments in these cases.
- FIX: When the "Compile Solution to Single Documentation" was used, only the regex filters from a base project were applied to all projects. Regex filters from individual projects were ignored.
- FIX: When you defined your own additional namespace placeholders in custom topics then a "ghost" "New Topic" was generated in documentation TOC.
- FIX: Class diagram was not generated if it was not updated according to actual source code. For example the diagram contained a deleted class. Now the diagram is generated and a compilation warning is displayed.
- FIX: When using the <include> tag in custom topics, the <summary> part was not included from external XML file.
- FIX: Compiling from command line with "compileProject" operation failed if the project was nested in a solution folder in its solution.
- FIX: When the "Compile Solution to Single Documentation" was used with RTF output, there were no code members present in a documentation.
- FIX: When you added a new file into VB project, the list of files to be compiled was cleared.
- FIX: Once you loaded a solution with only one project, the "Compile Solution to Single Documentation" and "Compile Projects in Solution Separately" buttons stayed disabled forever. Even when you later opened solution with more projects. You needed to restart Visual Studio and open the multi-project solution.
Version 5.0
(8. March 2010)
- NEW: Added support for Visual Studio 2010.
- NEW: Added Hebrew he-IL localization and right to left text direction support.
- NEW: Added Georgian ka-GE localization.
- NEW: Regex filters allow to search also in member XML comments.
- NEW: You can use new $CURSOR$ macro in comment templates. This macro specifies where the cursor will be positioned after inserting XML comment using "Add XML comment" function.
- NEW: Comment templates also for parameters. For example, the following sentence is generated for parameter of EventArgs type: "An EventArgs that contains the event data.". Due to these new commenting features you should update you preferences (you can use "Reset" button to get default templates with all new features).
- NEW: Extension methods are listed also on Members and Methods pages for types on which extension methods operate. This works for your own extension methods and also referenced (e.g. LINQ) methods. For example, if your class implements IEnumerable(T) interface, methods such as GroupBy, OrderBy, Average, and so on will be listed on its Members and Methods page.
- NEW: HelixoftHelpReg.exe utility accepts new -z argument now. When this argument is used, the utility always returns 0 (OK) as exit code, even if there was an error during execution. This is useful if you include HelixoftHelpReg.exe as custom action in your MSI package and you don't want to cancel whole installation if there is some problem with help registration. MSI automatically fails if custom action returns non-zero value.
- NEW: The $MEMBER-ASSEMBLY-VERSION$ macro which shows version number of documented assembly. You can use it anywhere in your comments, templates, footer or custom topics.
- CHANGE: Improved resolving of incomplete links. For example it is no longer necessary to prepend dot in <see cref=".prop1" /> link pointing to prop1 property in current class. Instead you can use just <see cref="prop1" />.
- CHANGE: Links to referenced external members that are not part of .NET framework (e.g. third-party controls) are no longer generated. Only the plain text is generated now. It's because there was only small chance that such help topic existed and these links caused "not found" error. If you still want to generate the links, you can set it manually in project properties. Just open .vsdoc file for the project and change value of "VBdocman_linkForExternalNotInFramework" key from 0 to -1 (there is no GUI option).
- FIX: When targeting .NET framework 3.0 and higher, the XML comments from framework members were not always inherited correctly.
- FIX: Links to generic members and to methods without parameters were broken in generated class diagrams.
- FIX: Links to online MSDN help didn't work for some members (e.g. System.Collections.Generic.LinkedList(T)) in generated html_msdn2 output.
- FIX: In html_msdn2 output, if there was inline link to external URL, there were no scrollbars when external document was displayed.
- FIX: WYSIWYG comment editor produced wrong cref links to methods whose parameters were constructed generic types, e.g. MyMethod(T).
- FIX: WYSIWYG comment editor produced wrong comments on some rare occasions - if there were blank lines inside <code>, bulleted or numbered lists contained only one item and others.
- FIX: Changes in comments in external XML comment files included with <include> tag were not updated in generated documentation. Restart of VS was needed.
Version 4.4
(8. October 2009)
- NEW: You can include clickable class diagrams in documentation. Create nice diagrams and insert them with <img> XML comment tag. The comment editor fully supports this feature. Class diagrams are only available in VS 2005 and higher.
- NEW: You can define unlimited number of user tags for your own sections in documentation. Previously it was possible to define only 5 user tags.
- NEW: You can create a table with more than 2 columns also directly in comment editor. In previous versions, you could edit and use such tables in editor but you needed to create them manually with the <list> tag.
- NEW: Added Chinese localization for generated output.
- NEW: Improved HTML output. You can now open particular topic directly. When you enter URL of some topic in the browser, the complete help with table of contents will be shown automatically. This way it is easy to send URL of particular topic to your customers or coworkers. To get URL of the topic, just right-click on the topic in TOC and select "Copy link" from browser context menu.
- NEW: Improved HTML output. The table of contents is automatically synchronized with topic open in right frame.
- NEW: The type name XYZ in text "(Inherited from XYZ.)" on members page is clickable link now.
- FIX: Opening comment editor with XML comment containing the <img> tag caused freezing of Visual Studio on Windows Vista. Initial insertion of picture worked well, however.
- FIX: The "Auto-find" button for searching the hxcomp.exe didn't work in VS 2008 with VS 2008 SDK installed.
- FIX: Some <see> links to custom non-API topics were not working in HTML documentation.
- FIX: There was no footer text in generated topics with enumerations.
- FIX: WYSIWYG comment editor didn't work if the documentation title for the project contained backslash character. This happened for web sites (not web applications) by default because there was web site folder path in the title.
Version 4.3
(12. May 2009)
- NEW: Added support for custom topics. Using WYSIWYG editor, you can now create any number of custom topics such as overview, examples, license agreement, usage descriptions, etc. You can define your own structure of table of contents (TOC) with topics and chapters. You can place generated API documentation anywhere in the TOC. You can even split API reference and insert specified namespaces at various places. This makes VSdocman really powerful tool for creating complete end-user documentation for your libraries and applications.
- NEW: Automatic and manual checking for VSdocman updates.
- CHANGE: You can use XML comment tags (e.g. <see>, <b>, etc.) in the topic footer text.
- CHANGE: Cosmetic change in options GUI. Renamed "Compile" section in project properties to "Code Members" and "Members" to "Member Types".
- CHANGE: In RTF documentation, the links to framework classes point to the latest online MSDN instead of the old one.
- FIX: The files from external files folder (e.g. pictures) were not included in documentation. This bug only appeared in version 4.2.
- FIX: VSdocman preferences were lost in VS 2002 and VS 2003. This bug only appeared in versions 4.x.
- FIX: Don't show Void as return type for constructors in C# and C++ syntax.
- FIX: In some cases, the link edited with Reference dialog was updated incorrectly in WYSIWYG comment editor.
- FIX: WYSIWYG comment editor didn't correctly show tables with more than 30 rows and 3 columns. Now it can handle tables with up to 100 rows and 30 columns.
Version 4.2
(5. March 2009)
- NEW: You can create tables with more than two columns.
- NEW: Comment editor recognizes and converts the following HTML elements in XML comments: <strong>, <em>, <a href=...>, <a name=...>, <see href=...>, <p>, <br/>, <ul>, <ol>, <li>, <table>, <tbody>, <th>, <tr>, <td> and <pre>. So you can use HTML code in your XML comments and when you open comment editor, it will be automatically converted to XML syntax.
- CHANGE: WYSIWYG comment editor no longer removes top-level XML comment tags that are not supported or explicitly defined by user in options. This way you can add any number of your own top-level XML tags manually without being worry that editor will delete them.
- CHANGE: WYSIWYG comment editor no longer removes <see> tags without the text, e.g. <see cref="T:MyNamespace.MyClass" />
- FIX: VSdocman crash when documenting generic VB method whose type argument is array, e.g. Function MyFunction() As Dictionary(Of String, Byte()).
- FIX: No syntax declaration was generated for C# methods without parameters. This bug was introduced in version 4.1.
- FIX: Inactive links were generated for <see> tags with incomplete cref attribute (e.g. only class name without namespace and T: prefix) in <summary> section. It worked fine in other sections such as <remarks>.
- FIX: Error with missing pubsinterface.gif file in Help & Manual output.
- FIX: Error message when clicking the Constructors link in members page header in *_msdn2 formats.
- FIX: Incorrectly formatted text in clipboard after using Copy Code in help2_msdn2 output.
- FIX: Freeze during compilation on Windows 7 beta.
Version 4.1
(3. February 2009)
- NEW: Added regex filters that allow include or exclude members from documentation according to their name, declaration and attributes.
-
NEW: Added support for the following XML comment tags:
<paramref>,
<typeparamref>,
<see langword="null"/>,
<see langword="true"/>,
<see langword="false"/>,
<see langword="static"/>,
<see langword="abstract"/>,
<see langword="sealed"/>,
<see langword="virtual"/>.
These tags allow formatting of parameter references and language keywords. It is recommended that you update your XML comment templates in VSdocman options if you update from version 4.0. You can do it with Reset button or manually (change e.g. <b>true</b> to <see langword="true"/>). - NEW: Added instant regex tester in comment rules editor.
- FIX: Incorrectly generated syntax declaration for extension methods.
- FIX: Sometimes, VSdocman froze on multiple screen systems. This happened when some of VSdocman windows was open on secondary screen. Its position was saved and the next time when secondary screen was not turned on, modal window was not visible and it looked like VSdocman was frozen.
- FIX: Compilation of documentation crashed with "Unspecified error" when there was no member selected for compilation, e.g. no source code file was selected in Compile - Files properties.
Version 4.0
(22. December 2008)
- NEW: Completely reorganized main window with new fresh look. Settings that are common to all projects were moved from project properties to global options.
- NEW: Improved WYSIWYG comment editor - new look, nicer highlighting of editable sections, TAB key is used to move between editable sections, improved selecting, deleting and pasting of text blocks.
- NEW: Flexible and intelligent templates for inserting XML comments. There are predefined rules which automatically fill <summary> and other values with standard text. For example, the following sentence is generated for constructor: "Initializes a new instance of the <CLASS-NAME-AND-LINK> class". You can define any number of your own rules. Moreover, when inserting comment, VSdocman can inherit comment from overridden member.
- NEW: Added Help & Manual output format. VSdocman supports complete integration with Help & Manual now. It is possible to create any TOC structure and additional non-API topics such as overview, license info, use cases, etc. Moreover, with H&M you can generate some other output formats, e.g. PDF.
- NEW: In addition to inherited members from project/solution, also inherited members from .NET framework classes are shown in Members list. For example, ToString, GetType and other methods are automatically listed. This is especially useful for documenting user controls where all inherited properties, methods and events are listed.
- NEW: Missing XML comments in overridden members are automatically inherited also from .NET framework classes, not only from project classes. For example, if your class inherits from System.Object and it overrides ToString() method and it has no XML comments, then comments from System.Object are automatically used.
- NEW: You can set your own documentation title. It is used in help window title, TOC, topic headers, etc.
- NEW: You can set language for code examples with lang attribute. You can use <code lang="C#"> and <code lang="VB">.
- NEW: You can set sort order for enumeration items - by name, by value or unsorted.
- NEW: Added <include> comment tag which allows referencing XML comments in external files.
- NEW: Highlighted code syntax in chm_msdn2, html_msdn2 and help_msdn2 otput formats.
- CHANGE: Significantly improved chm_msdn2 and html_msdn2 output - new look of the latest MSDN, language filter with persisted language settings. Moreover, the links to framework members are always working in chm_msdn2 output. Depending on installed MSDN version on end user's computer, the links point either to the latest local MSDN or online MSDN.
- CHANGE: Title page text can be formatted with XML documentation tags such as <para>, <b>, <img>, etc.
- CHANGE: The XML documentation file is generated also for Web Site projects.
- FIX: The "List inherited members" option on Compile - Members page was not saved.
- FIX: No more "Dead link..." warnings when <see> or <seealso> tags pointed to .NET framework members.
- FIX: Incorrect displaying of national (e.g. Russian) characters in Index and Search results in CHM outputs.
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)
VSdocman 11.2
Documentation generator for C# and VB .NET.
Companies and organizations
If you are a company or an organization, you need to purchase the commercial license(s). One license is required per developer who uses VSdocman. With this license, the developer can install the product on any machines, provided that the developer is the only or exclusive user of the software.
VSdocman |
||||
Number of Licenses | Price per License | Discount | ||
1 | 195 USD | 169 EUR | ||
2 | 169 USD | 149 EUR | 13% | |
3 - 5 | 149 USD | 132 EUR | 23% | |
6 - 10 | 132 USD | 115 EUR | 32% | |
11 and more (see also the option below for more users) |
122 USD | 106 EUR | 38% | |
For larger teams: |
||||
VSdocman (Site License) for unlimited number of developers |
2549 USD | 2219 EUR |
Individual developers
You can purchase a license for your personal use if you are the only person who will use that license. You must be a physical person and you must purchase the software with your own funds only. Personal licenses are non-transferable, and they are not available to companies.
VSdocman (Personal License) |
84 USD | 73 EUR |
Registered users will get:
- full perpetual product license
- free email support for the period of one year
- free updates within one year of any registered purchase
- discounts on non-free upgrade
How the registration works
When you buy VSdocman license, you become a registered user. It is quick and easy. Usually, you will have the full version in a while. Sometimes it may take several hours.
Immediately after the payment is accepted you receive an e-mail with your registration code (license key). Download and install the trial version of VSdocman. In Visual Studio, open VSdocman main window and press REGISTER button to enter the code.
VSdocman renewal or upgrade from earlier versions
If you own version 8.0 or higher
Starting with VSdocman 8.0, you can install any new product version for free, provided that it was released before or within one year of your purchase. It doesn't matter if the new version is a major or just a minor update. All that matters is just the time period. The purchased registration key will work with those VSdocman versions. Then you can keep using the product forever.
However, the registration key will not work with those VSdocman versions that were released after one year after your purchase. In such a case, VSdocman will show you a message and it will switch to the trial mode. You can whether renew your license and get a new key for another year, or install a version released within the supported time period.
Your license status and the free update period is shown on the About dialog. You can open it by clicking the About button on the main VSdocman window.
If you own version 7.6 or earlier
You need to renew your license, if you want to use newer versions. If you don't want to upgrade, you can download the latest version of VSdocman which will work with your registration key.
How to renew
To renew your license for the latest vesion, you need to purchase a new registration key. The renewal price is only 40% of the full price. All registered users will receive a notification email with instructions how to get the discount. Or you can contact us to get the information.
You can buy our products in more than 90 currencies, including: Euro, US dollar, British pound, Australian dollar, Japanese yen, Canadian dollar, Swiss franc, Russian rouble, Brasilian real, Norwegian krone, Swedish krona, Polish zloty, Chinese renminbi yuan, Taiwan dollar, Indian rupee.
We use Verifone (formerly 2Checkout) for registration and order processing. Verifone (2Checkout) is a well-known, leading software commerce service. For further information regarding your order visit Verifone FAQ.
If your registration key is no longer valid for the current version, you have two options:
- You can upgrade (renew) to the latest version.
- If you don't want to upgrade, you can download the latest version of VSdocman which will work with your registration key.
Below is the download archive of the previous releases. For detailed information see also VSdocman release history.
Release date | Version |
2022 Jan 26 | VSdocman 11.2 |
2021 Dec 23 | VSdocman 11.1 |
2021 Dec 18 | VSdocman 11.0 |
2021 Mar 30 | VSdocman 10.0 |
2020 Oct 30 | VSdocman 9.10 |
2020 Sep 25 | VSdocman 9.9 |
2020 Sep 21 | VSdocman 9.8 |
2020 Jun 18 | VSdocman 9.7 |
2020 Jun 9 | VSdocman 9.6 |
2020 Jan 14 | VSdocman 9.5 |
2019 Oct 28 | VSdocman 9.4 |
2019 Sep 7 | VSdocman 9.3 |
2019 Jun 26 | VSdocman 9.2 |
2019 Apr 30 | VSdocman 9.1 |
2019 Apr 24 | VSdocman 9.0 |
2018 Oct 2 | VSdocman 8.6 |
2018 Jul 8 | VSdocman 8.5.2 |
2018 Jun 25 | VSdocman 8.5 |
2018 Jan 11 | VSdocman 8.4 |
2017 Dec 12 | VSdocman 8.3 |
2017 Jul 12 | VSdocman 8.2 |
2017 May 16 | VSdocman 8.1 |
2017 Feb 27 | VSdocman 8.0 |
Versions 7.6 and earlier
If you have registered a major version of VSdocman older than 8.0, your registration key will not work with a newer version. Your registration key is only valid for one major version. If you for example purchased version 6.x, the key will not work with version 7.x.
{multithumb caption=0}Here is an example how to generate documentation for your VB .NET or C# project in a few seconds in the easiest case.
After installation, VSdocman button appears in the Tools menu and on the standard toolbar as well.
This button invokes main VSdocman window where you can set various settings.
Press Compile Project button on Compile pane. Compilation progress dialog appears and some log messages are printed in it.
You can then test generated documentation by pressing the Show Documentation button.
{multithumb caption=0}VSdocman can generate documentation even without any additional comments in the source code. All Methods, Properties, Events and other links are generated properly and parameters descriptions and other sections are also included.
However, it is good to include additional descriptions directly into the source code. It is done by adding standard XML comments which VSdocman understands in both C# and VB .NET.
Commenting is based on tags that are included in your comments.
For example
/// <summary>This is my method.</summary>
/// <remarks>This is a remarks section</remarks>
void MyMethod()
Automatic Addition of Comment
User can write all that comment manually but he is not required to do so. VSdocman can do that automatically. VSdocman has an intelligent mechanism for inserting comments. Depending on code element name or type, you can easily insert predefined default comment. For example, the "Gets or sets a value indicating whether ..." summary text is automatically generated for boolean properties. This is controlled by comment templates which are fully customizable by user. There are some predefined templates for the most common cases.
When user clicks right mouse button on the code window, the pop-up menu appears. Menu contains Add XML Comment, Comment Editor and Add Description Attribute items which perform the following actions:
-
Add XML Comment automatically adds the default XML comment to the current member. User can preset how the default comment should look like.
-
Comment Editor invokes the WYSIWYG Comment editor for selected member. This is useful when creating complicated documentation including cross-references, pictures, tables and others. Comment editor provides a user-friendly graphical way for editing the comments.
-
Add Description Attribute automatically adds the Description attribute to the current member. Short property description in Properties Window must be defined with System.ComponentModel.Description attribute.