Specador Documentation Generator User Guide
Rev. 17.1.8, 18 April 2017

Chapter 7. What is New?

#.# - major version - Includes new features, major enhancements, architectural changes, bug fixes. 
Since 2015, a major version is named in sync with the release year, for example the first major version of 2015 is 15.1.
NOTE: When switching to a new major version it is recommended to start in a new workspace.

#.#.# - minor version - Includes bug fixes, minor enhancements.

17.1.7 (10 April 2017)

Bugfixes

  • DVT-8800 Comment lines with words containing the element name are stripped from documentation

  • DVT-9796 Specador: Go to element from global search does not work for mixed-language documentation

17.1.1 (24 February 2017)

Features

  • DVT-3079 Generate Finite-State Machine Diagrams

Enhancements

  • DVT-7673 Fail when files passed as arguments do not exist

16.1.37 (24 February 2017)

Bugfixes

  • DVT-9375 Diagrams from referenced documentation are regenerated if the reference is outside of the project

16.1.35 (1 February 2017)

Enhancements

  • DVT-9146 Add the diagram-max-nof-nodes in DTD for auto complete

Bugfixes

  • DVT-9365 Global scope API filter does not work

  • DVT-9418 Macros are documented even if excluded but Global Scope is selected

16.1.31 (9 December 2016)

Enhancements

  • DVT-8159 Ignore @brief tags lines in comments

  • DVT-9132 Add covergroup information in class, struct, unit pages

  • DVT-9131 Ability to skip a header comment candidate that matches a simple pattern or regex when using +dvt_extract_comment_header+

  • DVT-9134 Ignore invalid HTML tags when parsing comments as JavaDoc

Bugfixes

  • DVT-9293 Fix NullPointerException when +dvt_auto_snps_vip_* flags are used

16.1.27 (28 October 2016)

Bugfixes

  • DVT-9122 Build config: irun location is not correctly inferred when compiling in batch mode

16.1.22 (12 September 2016)

Bugfixes

  • DVT-8948 When testbench classes reside under a program, they are not available in the main index

16.1.16 (8 July 2016)

Enhancements

  • DVT-8135 Check that executed script is part of the same distribution where $DVT_HOME points to

16.1.9 (9 May 2016)

Features

  • DVT-8567 Ability to add block, flow and schematic design diagrams using export-design-block-diagram, export-design-flow-diagram, export-design-schematic-diagram

Bugfixes

  • DVT-7496 Expand on e Language checks page groups doesn't work

16.1.2 (3 March 2016)

Bugfixes

  • DVT-8326 No documentation generated for inner enums, structs or classes

  • DVT-8340 Wrong Java path in MacOS distros

16.1.1 (24 February 2016)

Enhancements

  • DVT-7978 Updated JRE in distribution to version 1.8.0u66

  • DVT-8275 Build with Java 8, minimal JRE required version increased to 1.8

15.1.37 (23 December 2015)

Enhancements

  • DVT-8156 SystemVerilog: Add preference to enable/disable "Ifndef Guard Defines" extraction to HTML, do not generate by default

  • DVT-8157 SystemVerilog: Add preference to enable/disable "Control Defines" extraction to HTML

15.1.34 (28 November 2015)

Enhancements

  • DVT-8111 Add a preference to skip class diagram generation if maximum number of nodes exceeds a specified threshold

15.1.33 (20 November 2015)

Performance

  • DVT-8092 SystemVerilog: Improve the performance of assertions and packages analysis

15.1.32 (18 November 2015)

Bugfixes

  • DVT-8085 Sometimes license checkout fails when using the latest FlexLM server (11.13.1)

15.1.27 (8 October 2015)

Bugfixes

  • DVT-7927 Wrong package comment processing when used for the overview page

15.1.25 (22 September 2015)

Enhancements

  • DVT-7836 Ability to create URL for HTML frame content in order to simplify sharing links to specific pages

15.1.24 (18 September 2015)

Enhancements

  • DVT-7832 Ability to use a specific package documentation as the overview page

  • DVT-7833 Ability to filter UVM API from index and macros pages in order to avoid clutter

  • DVT-7834 Show functions and tasks in generated documentation for interfaces

  • DVT-7835 Provide legend for class diagrams in generated documentation

Bugfixes

  • DVT-7888 Wrong progress report when linking external documentations

15.1.22 (2 September 2015)

Enhancements

  • DVT-7829 Add diagram generation process timeout (1 minute)

15.1.18 (10 August 2015)

Performance

  • DVT-7739 Improve Specator HTML search box performance

Enhancements

  • DVT-7737 Add preference to show brief comment in index tables

15.1.17 (3 August 2015)

Features

  • DVT-7727 New specador.bat Windows script

Enhancements

  • DVT-6930 Ability to link header comment to first significant element in file

15.1.16 (27 July 2015)

Deprecated

  • -gen_html_doc_from_settings is deprecated, use -preferences instead

  • -get_html_doc flag is deprecated, use -title instead

Enhancements

  • DVT-7664 Enhance progress reporting in batch mode - what file is currently generated, how long it takes

  • DVT-7665 Use both extern and implementation function argument comments when generating documentation

  • DVT-7667 Don't modify the capitalization of the first word in the sentence if that word is in fact the identifier name

  • DVT-7669 Ability to pass custom menu by command line

  • DVT-7670 Ability to pass title by command line

Bugfixes

  • DVT-7663 Use portable awk syntax in scripts

  • DVT-7687 Avoid silent exit after a StackOverflowError or OutOfMemoryError

15.1.11 (20 May 2015)

Bugfixes

  • DVT-7474 License error due to a NullPointerException in FlexLM

15.1.10 (15 May 2015)

Bugfixes

  • DVT-7449 RuntimeExceptions are thrown when generating documentation that contains some diagram types

15.1.1 (27 February 2015)

Enhancements

  • DVT-7065 Build for Java 7, minimal JRE required version increased to 1.7

3.5.35 (30 January 2015)

Bugfixes

  • DVT-6284 Diagrams in Specador should reflect architectures not entities in VHDL

3.5.32 (18 December 2014)

Bugfixes

  • DVT-6900 Generated design diagrams are empty

3.5.30 (28 November 2014)

Bugfixes

  • DVT-6854 No license found when using Specador for SystemVerilog

3.5.26 (31 October 2014)

Enhancements

  • DVT-6766 Use new HTML look & feel by default

3.5.25 (23 October 2014)

Enhancements

  • DVT-6431 VHDL: Added architecture instances and sub-instances

3.5.24 (10 October 2014)

Enhancements

  • DVT-6278 Added compile waivers in functionality

  • DVT-6710 Added support for clocking blocks

3.5.23 (2 October 2014)

Features

Enhancements

  • DVT-6213 Refine parameters documentation

  • DVT-6688 Show parameters in the inheritance tree

  • DVT-6689 Refine interfaces documentation (ports, variables, modports, clocking blocks)

3.5.19 (21 August 2014)

Bugfixes

  • DVT-6553 Specador compiles all files according to -lang switch in a mixed language build configuration regardless of extension mappings

  • DVT-6565 Specador complains about non-existing irun executable even if not in ius.irun compatibility mode

  • DVT-6570 FileNotFoundException (Not a directory) when generating documentation using the new HTML style

3.5.18 (1 August 2014)

Bugfixes

  • DVT-6470 Specador "-h" shows help but also prints an error

3.5.17 (25 July 2014)

Features

  • DVT-5560 Ability to customize the HTML look & feel when new HTML style is used

  • DVT-6487 Ability to inject HTML in generated documentation when new HTML style is used

Bugfixes

  • DVT-6526 Watermark footer missing in new HTML style

3.5.16 (8 July 2014)

Features

  • DVT-6485 Specador: New HTML look & feel

Enhancements

  • DVT-6279 SystemVerilog API defined under a class should appear only under that class and not under global API

  • DVT-6434 SystemVerilog remove covergroups, assertions, functions, tasks, variables from index page and search

Bugfixes

  • DVT-5550 Specador: Method argument comments are not extracted

  • DVT-6210 Specador: Fixed JavaDoc @link hyperlink extraction when similar links are used

3.5.14 (24 June 2014)

Bugfixes

  • DVT-6353 VHDL Overloaded functions are not visible

3.5.13 (13 June 2014)

Enhancements

  • DVT-6282 Validate the settings XML before compilation

Bugfixes

  • DVT-6331 Wrong hyperlinks when including external documentation directories

  • DVT-6333 Show the external documentation title under the 'Referenced Documentation' section in TOC

3.5.12 (10 June 2014)

Bugfixes

  • DVT-6285 & DVT-6287 Exceptions when generating documentation in certain configurations

  • DVT-6286 Exception when generating documentation with module diagrams with ports

  • DVT-6288 FileNotFoundException when documentation is generated with diagrams in the same location for multiple projects

  • DVT-6304 Progress dialog should also include design diagrams and design diagrams with ports

3.5.11 (30 May 2014)

  • First version