We are glad to announce that a new version 8.1 of VSdocman has been released. VSdocman is a Visual Studio tool for a quick commenting and automatic generation of technical documentation from your C# and VB .NET source code files. For more information go to VSdocman home page .
This minor update adds support for new project types, new features and fixes some problems. You can download it from here.
What's new in VSdocman version 8.1:
- NEW: Added support for .NET Core and .NET Standard projects in Visual Studio 2017.
- NEW: The generated documentation shows the return type of a method return value or a property and field value, similarly as it's been shown for method parameters.
- NEW: Added syntax highlighting for VSdocman output templates (.vbdt files). You only need to edit the output templates if you want to customize the look and feel of your generated documentation. You can now do it directly in Visual Studio with highlighted macros and comments. See <VSdocman folder>\Templates\Vbdt editing\readme.txt for more details.
- NEW: Added ability to generate an improved Index in CHM output formats. Such index allows for better context help invocation from external applications. See Viewing and Deploying Documentation > View and Deploy CHM Documentation page in VSdocman help for more details.
- CHANGE: The link selector in the Comment editor no longer generates <see> links with a prefix, e.g. T:System.String. This way the Intellisense will work fine for such links in VS code editor.
- CHANGE: The links generated in the default comments (e.g. after Add XML comment for constructor) no longer contain a prefix, e.g. T:System.String. This way the Intellisense will work fine for such links in VS code editor. Moreover, the links are created in the short format, e.g. <see cref="System.String"/> instead of longer <see cref="System.String">String</see>. You can apply these new options by pressing Reset button in VSdocman Options. You can backup your current options with the Export button first.
- CHANGE: Indexers in C# (properties with parameters in VB .NET) were always listed as 'this[...]' in generated TOC and member list tables. Now, this is changed to Item(...), or to the value of the System.Runtime.CompilerServices.IndexerName attribute, if this attribute is applied or to the property name, if it is a VB property.
- CHANGE: Previously, it was possible to create more than two columns only at the time when a table was created in WYSIWYG comment editor. The "Insert column" menu item is no longer disabled if a table has 2 or more columns so you can add a column at any time now.
- FIX: Smarter resolving of incomplete cref links. The search is performed also in all parent namespaces/types of the current type. For example, the link cref="Class1" in A.B.C.D.Class2.Class3 will be correctly resolved to A.B.Class1.