Doxygen latest release v1.7.6.1 - last page update Sat Dec 10 2011

Doxygen Release 1.7.6.1

(release date 10-12-2011)

Changes

  • Doxygen now reports its cache usage (for the symbol and the lookup cache) at the end of a run (if QUIET=NO), and recommends settings for SYMBOL_CACHE_SIZE and LOOKUP_CACHE_SIZE for your project if either cache is too small.

New features

  • Added new option LOOKUP_CACHE_SIZE to control the internal cache doxygen uses to find symbols given their name and a context.
  • Python: added support for @staticmethod

Bug fixes (ids refer to the bugzilla database)

  • Python: scopes are now shown with . instead of ::
  • id 665313: Space before @if was not preserved, causing problems with inline @if .. @endif constructs.
  • id 665583: Fixed XHTML validity problem when using mscgen graphs.
  • id 665641: Fixed XHTML validity problem when GENERATE_TREEVIEW was disabled.
  • id 665720: Included patch to fix hang issue when non-empty INCLUDE_PATH was used.
  • id 665778: Fixed parse issue when a comma appeared as part of an enum's value.

Doxygen Release 1.7.6

(release date 03-12-2011)

Changes

  • To improve the performance of loading the navigation tree, the data is now split into multiple javascript files which are loaded dynamically.
  • The selected member is now briefly highlighted in the HTML output (when GENERATE_TREEVIEW is enabled).
  • The navigation tree (GENERATE_TREEVIEW) now shows the same information as the index.
  • The navindex section of layout now also controls what is shown in the navigation tree.
  • Improved HTML output support for IE9.
  • Included redesigned VHDL parser (thanks to Martin Kreis for the patch)
  • When a class/structs has many (>15) members of the same type, only the first 10 are shown in the UML diagram.
  • Made the output of the javascript based search engine more compact.

New features

  • Update of the French translation.
  • id 607305: Added support for PHP heredoc and nowdoc constructs.
  • Added support for cross-referencing in case of operator-> overloading. This includes support for std::auto_ptr,std::smart_ptr,std::unique_ptr and std::weak_ptr when BUILTIN_STL_SUPPORT is enabled.

Bug fixes

  • Regression: some information was no longer available for a class, due to accidental deletion of a code block.
  • Regression: fixed matching problem in the code parser.
  • Included fixes for TCL to support commands with \ and command definitions preceded by whitespace (thanks to Rene Zaumseil)
  • When using "static int a,b" variable "b" incorrectly appeared in the output even though EXTRACT_STATIC was set to NO.
  • id 521717: .spec file was only updated after running ./configure
  • id 656642: Fixed potential crash when using doxygen for large projects.
  • id 656878: Fixed problem running bibtex with \cite command on Windows.
  • id 657152: Fixed constant expression evaluation error in the preprocessor.
  • id 652277: Removed bogus ' from the man page output.
  • id 659244: Quotes in the brief description could appear unescaped in the tooltip.
  • id 641336: #includes with ../ were not always processed correctly.
  • Fixed potential crash when INLINE_GROUPED_CLASSES and INLINE_SIMPLE_STRUCTS are set to YES.
  • id 658896: Fixed preprocessor problem handling #defines whose value was a constant string containing ///.
  • id 660332: Using a \ at the end of a comment line could cause parsing problems for C# as the \ was treated as a line continuation.
  • id 658033: Fixed parser problem when using multiple member groups inside a macro definition.
  • id 503239: Fixed several issues related to \cite handling.
  • id 658587: Improved the way macro definitions are collected.
  • id 660501: Fixed LaTeX error when using \name with a description.
  • id 661292: The documentation for \mainpage incorrectly mentioned that one has to use \ref main in case GENERATE_TREEVIEW was set to YES, which is no longer the case.
  • id 659096: Nested aliases definitions where not always expanded properly (regression w.r.t version 1.7.4)
  • id 658038: Fixed preprocessor problem where the @ character inside a macro definition could appear as @@.
  • id 658646: Fixed problem running mscgen for LaTeX and RTF output.
  • id 661723: Using ClassName%'s did not work anymore, and also ClassName's wasn't autolinked.
  • id 662044: Fixed potential printing of null pointer when using a version filter that returned blanks.
  • id 625518: Fortran: first problem where subroutine using results variable appeared as a function.
  • id 654153: If an URL appeared at the end of a sentence, the period was included in the URL.
  • id 656560: Fortran: Added support for the Double Complex type.
  • id 663640: Included workaround for Solaris CC issue in index.cpp
  • id 662190: Included patch to fix some TCL issues and add the TCL_SUBST configuration option.
  • id 661672: Fortran: Added support for ALIAS expansion in comment blocks.
  • id 663101: Fixed case where a macro was not corrected found in the header file when it could only be found via INCLUDE_PATH.
  • id 664718: using multiple <para>'s inside a <summary> block caused text to be joined without spacing.
  • id 656556: Java enums are now parsed as classes.
  • id 664826: Fixed problem in the preprocessor regarding the handling of include guards.
  • id 664893: Fixed typo in the docs for EXCLUDE_SYMLINKS.
  • id 665466: Using a relative URL with <a href> did not work when CREATE_SUBDIRS was enabled.
  • id 665464: Using an absolute URL with <img> did not work when CREATE_SUBDIRS was enabled.

Doxygen Release 1.7.5.1

(release date 21-08-2011)

New features

  • Update of the French translation.

Bug fixes

  • id 521717: .spec file was only updated after running ./configure
  • id 656642: Fixed potential crash when using doxygen for large projects.
  • id 656878: Fixed problem running bibtex with \cite command on Windows.
  • Regression: some information was no longer available for a class, due to accidental deletion of a code block.
  • Regression: fixed matching problem in the code parser.

Doxygen Release 1.7.5

(release date 14-08-2011)

Changes

  • id 641904: Function in the call graphs are now shown based on first appearance rather then alphabetical order.
  • id 616213: When customizing the HTML header $title now only generates the title excluding the project name (which can still be added using $projectname)
  • Improved the look of the class index: all items now have equal spacing.

New features

  • New option INTERACTIVE_SVG which when set to YES in combination with DOT_IMAGE_FORMAT=svg will make doxygen generate interactive SVG diagrams that support zooming and panning via the mouse (only for large graphs).
  • Added support for the Tcl programming language (thanks to Rene Zaumseil and Samuel Bentley for the patch).
  • Added @copyright command.
  • added option MATHJAX_EXTENSIONS to provide additional extensions for MathJax (thanks to David Munger for the patch).
  • added option INLINE_SIMPLE_STRUCTS which when enabled shows the fields of simple classes and structs (with only public data fields) as a table and inline in context (file/group/namespace/class) provided this context is documented.
  • When using the server based search engine (SEARCHENGINE=YES and SERVER_BASED_SEARCH=YES) doxygen now advertises a opensearch provider for your project, that allows integrating the search directly in the search field of the browser (thanks to Phil Lello for the patch).
  • id 503239: Added new option CITE_BIB_FILES and LATEX_BIB_STYLE and a new command \cite, allowing you to make references to literature (as defined in one or more .bib files). This also works for output formats other than LaTeX. The tool bibtex is required for this to work though. Thanks to David Munger for the initial patch upon which this feature is based.
  • PHP namespaces are now shown as A\B in the output.
  • Added new \snippet command that can be used to include marked sections from a source file. See http://www.doxygen.org/commands.html#cmdsnippet for more info.
  • Added translation support for Armenian, thank to Armen Tangamyan. and included translation updates for a number of languages.

Bug fixes

  • Fixed a couple of potential race conditions found by Helgrind while running dot from multiple threads.
  • Graphs did not appear when enabling both INTERACTIVE_SVG and HTML_DYNAMIC_SECTIONS.
  • PDFs generated by newer versions of dot (i.e. 2.28) did not appear in the output, because doxygen failed to extract the bounding box.
  • Improved call graph and cross-reference support for Python.
  • INTERACTIVE_SVG now also works with IE9 if the html file extension is set to xhtml.
  • Fixed several cases where the LaTeX output could produce too long lines.
  • id 318061: Putting two functions in the same group that only different in the number of template arguments did not work.
  • id 437346,564614: Fixed proper encoding of multibyte output in RTF depending on the code page (thanks to Hirao for the patch).
  • id 521717: The .spec file in the source distribution did not get updated to the latest version.
  • id 521861: Fortran: Continuation character was not recognised in fixed format code.
  • id 522496: Fortran: @param checking was not case insensitive.
  • id 560105: Fixed problem combining @cond with preprocessor directives.
  • id 577359: Using "struct A : C, D {};" showed a private inheritance relation for D.
  • id 584194: Some links to typedef where pointing to the typedef'ed class instead.
  • id 619560: Anonymous enums caused an invalid entry in the LaTeX TOC.
  • id 622935: Deriving from an unknown template class could cause the class to appear with a -g postfix in C#
  • id 625731: Fortran: Fixed issue handling private subroutines.
  • id 632946: LaTeX now starts a new page when starting a new module.
  • id 634837: Fortran: Prefix of function was overwritten and the word 'function' not specified.
  • id 637099: Fortran: Included fix for using collaboration diagrams.
  • id 642468: Added PHP support for namespace with curly braces.
  • id 643219: Fortran: Improved handling of semicolons.
  • id 643617: Fortran: Added support for "type is".
  • id 643944: A macro added to a group appeared twice in the group documentation if was also made related to a class using \relates.
  • id 646321: Fixed problem were the search box was missing when using a custom HTML header.
  • id 646447: Fixed unterminated img tab in the XHTML output.
  • id 646463: Fixed problem handling MSCFILE_DIRS option with multiple paths.
  • id 646533: Included patch to sort overloaded members by appearance in the code.
  • id 646747,646879: Putting an autolist inside a @todo, @bug or similar section did not work anymore.
  • id 646922: Referring to a logo with a relative path, caused a broken image target when using a custom HTML header.
  • id 647499: Fixed HTML rendering problem on older browsers when GENERATE_TREEVIEW was enabled.
  • id 647768: Linking to a section on the main page could result in a broken link when GENERATE_TREEVIEW was enabled.
  • id 647889: Fixed invalid warning when using @deparated method with default values for parameters.
  • id 648302: A function made related using @relates could end up in the wrong class if there was already a method with a matching argument list in that other class.
  • id 649103: Return types containing multiple *'s ended up in the output with only one * in some cases.
  • id 650397: Fixed problem with alias substitution if the alias had more then 9 parameters.
  • id 650430: For nested anonymous structs @xx markers could appear in the output.
  • id 650463: Added compilation support for MacOSX 10.7 (aka Lion).
  • id 650958: Fixed issue printing HTML pages when the GENERATE_TREEVIEW option is set to YES.
  • id 651611: Fixed broken link to an undocumented namespace.
  • id 652138: Fixed potential crash while parsing Fortran code.
  • id 652188: Fixed problem parsing comment which included an unterminated alias within quotes (i.e. "\word{")
  • id 652277: Lines starting with . did not appear in the man page output.
  • id 652389: Fortran: Fixed text is detailed function section.
  • id 652396: When enabling INTERACTIVE_SVG wide graphs are now also fit to the screen width.
  • id 652695: Added missing space between parameter type and name in the RTF output.
  • id 652741: Use background-color instead of background in doxygen.css.
  • id 653344: Fixed potential segfault while creating man pages.
  • id 653666: Fortran: add a space to "type" in argument list.
  • id 653801: Fixed problem handling include guard when multiple blocks guarded by the same guard were used in a header file.
  • id 653963: Fortran: Unified handling of @params at various places.
  • id 654108: make clean failed on a system without qmake.
  • id 654244: Fixed compile issue for HP Itanium.
  • id 654779: Fortran: Interface was seen as a class with constructor / destructor.
  • id 654869: Using the word "property" as a type in C caused wrong results.
  • id 654866: Fortran: fixed issue parsing function type that looked like C function pointers.
  • id 655178: Fortran: Fixed parse issue when using variable name starting with the word interface.
  • id 655591: Improved error handling for empty html style list.
  • id 655935: Fixed case where %s could end up in a warning messge.
  • id 656005: Methods of Objective-C categories defined in an .m file are now marked as private.

Doxygen Release 1.7.4

(release date 28-03-2011)

Changes

  • doxygen -w html now reads the default Doxyfile even if not specified explicitly
  • doxygen -w html now produces a template header and footer that can be used independent of the configuration options used.

New features

  • New option INLINE_GROUPED_CLASSES that when enabled shows grouped classes inside the group documentation, instead of on a separate page.
  • Included updates for the Italian and Russian translation.
  • id 640875: Added option HTML_EXTRA_FILES which makes it easier to copy additional files to the HTML output and also add them to the index files.
  • id 642579: Included patch that adds new LATEX_FOOTER option to customize the end of refman.tex in the LaTeX output.

Bug fixes

  • id 140259: Jumping to a @section did not work in the RTF output.
  • id 521854: Fortran: included patch for supporting multiple argument declarations on one line.
  • id 521861: Fixed problem with line continuation in Fortran.
  • id 566921: %A::B now prevents a link for A::B, instead of only for A and generating a warning that ::B cannot be linked.
  • id 598481: Fortran: Added support for extends keyword.
  • id 618374: Added support for inlining code in the VHDL output.
  • id 625519: Fortran: argument name starting with a reserved word was not handled properly.
  • id 634415: Fixed problem parsing an array of character literals.
  • id 635537: Links to file members were not made when found in tag files.
  • id 638637: The Doxyfile documentation contained some very long lines.
  • id 638655: Double quote in page or group title broke treeview.
  • id 638733: Improved documentation for DOT_IMAGE_FORMAT option.
  • id 638829: Added documentation to warn for consequences of using HTML_HEADER.
  • id 638856: Fixed problem autolinking to struct field using #S::a
  • id 639272: using @dot...@endot produced an image referenced with absolute path.
  • id 639521: \mscfile did not work properly for LaTeX output.
  • id 639716: Fixed problem where #include's could cause phantom __pad__ members to appear in the output (appeared on Windows only).
  • id 640259: Options PROJECT_LOGO and PROJECT_BRIEF were missing from the manual.
  • id 640463: Fixed problem parsing PHP "use" statement when the argument did not have a namespace scope.
  • id 640588: Included fix for proper splitting of multiple arguments given to the QHP_CUST_FILTER_ATTRS option.
  • id 640646: Long error messages could cause memory corruption.
  • id 640742: XML: switched indent option to no in the combine.xslt script.
  • id 640754: Comment with XML style list of type table was not rendered properly.
  • id 640822: Added support for overloading of C# indexer operators.
  • id 640828: Internal section marked with @internal was not shown as such anymore in the XML output.
  • id 640847: PHP: Fixed parse problem referring to class in global namespace.
  • id 640924: Included patch by Haffmans to make the custom header and footer independent of the chosen config options.
  • id 640927: Included fix to prevent a warning in the server side PHP search script.
  • id 641026: Included patch to fix broken hyperlink to page entry in xreflists.
  • id 641188: Header of \page was wrong in Man page output.
  • id 641336: #include's to other directories were not always linked.
  • id 641673: Using "use Foo\Foo;" in PHP could cause doxygen to hang.
  • id 641814: In some cases the HTML output could contain an extra </p>.
  • id 642030: Tooltips with HTML entities could be wrongly truncated.
  • id 642475: Include graphs could be incomplete.
  • id 643056: Fixed problem with macro expansion.
  • id 643279: Fixed potential crash when generating a warning for void f(int %x) style parameter, which is valid in C++/CLI.
  • id 643280: Included patch to enabled LargeAddressAware for Windows builds.
  • id 643276: Fixed cases where FILE_VERSION_FILTER was called for dummy files with name "generated".
  • id 643655: Fixed argument matching issue when one of match candidates was a typedef of a method pointer.
  • id 645754: mscfile tag was closed with dotfile in the XML output.
  • doxygen -w html now ignores the values for HTML_HEADER and HTML_FOOTER found in the config file.
  • Importing a group via a tag file could overrule a local group with the same name even when EXTERNAL_GROUPS was disabled.

Doxygen Release 1.7.3

(release date 03-01-2011)

Changes

  • Added a header for each HTML page above the navigation menu, showing the project name and logo and a short descriptin (all optional). Disabling the index (with DISABLE_INDEX) still shows the new header (you can still customize this using HTML_HEADER). This now works nicely in combination with GENERATE_TREEVIEW = YES and/or SEARCH_ENGINE = YES.
  • Redesigned the treeview feature. Instead of using frames, the navigation tree is now loaded on each page dynamically. This allows bookmarking a page and always keeps the top menu visible. Also the current item is automatically highlighted in the tree. Also updated the icons in the treeview to match the overall look'n'feel. Note: if you now use a custom HTML header, please update it using doxygen with the -w and the edit the default header.

New features

  • id 499544: Added SVG support to doxygen's dot output (setting DOT_IMAGE_FORMAT to svg now works as expected)
  • Added control to the wizard to configure the color of the output visually.
  • Added options to specify project synopsis and select a project logo to the wizard.
  • Added option PROJECT_LOGO which can be used to specify an image which will be shown in the header of each HTML page along with the project name (PROJECT_NAME option).
  • Added option PROJECT_BRIEF which can be used to specify a brief description which will be shown in the header of each HTML page just below the project name.
  • Added new option FILTER_SOURCE_PATTERNS which can be used in combination with FILTER_SOURCE_FILES to filter files used for the source browser based on file extension, which can overwrite the filter set by FILTER_PATTERNS and/or INPUT_FILTER.
  • Added new option STRICT_PROTO_MATCHING which is disabled by default, and makes the parameter matching to be less strict, resulting in fewer "No matching class member found" warnings.

Bug fixes

  • id 306076: code blocks with using directives did not get hyperlinked.
  • id 313527: enum values with bitfields did not get parsed correctly.
  • id 565715,630582: Included a patch that fixes a couple of Fortran issues (thanks to Albert).
  • id 615507: Fixed problem handling @cond..@endcond in Fortran code.
  • id 619040: Scope was missing in Tokens.xml when using docsets.
  • id 625517,523156: Applied patch tp avoid stripping prefixes for Fortran subroutines.
  • id 626476: allow label before end statement in Fortran
  • id 630901: </see> was not handled properly in comment block.
  • id 632311: Fixed potential crash for empty verbatim section.
  • id 632426: closing brace of a function with one parameter has wrong color in HTML.
  • id 632543: Added support for Fortan TYPEs with languge bindings. (thanks to a patch by Daniel Franke)
  • id 632879: An explicit link request such as #blah did not longer produce a warning if no symbol named blah was found.
  • id 633891: warnings in "inbody" documentation were shown with "unknown" file name.
  • id 634116: Titles customized via the layout file did not appear in the title page and navigation tree, only in the top menu.
  • id 634600: Fixed problem resolving typedef.
  • id 634775: Fixed a problem were // inside a code block got removed.
  • id 634857: Added support for escaping :: by using \:: (or @::)
  • id 634962: #include with relative path to parent dir did not get hyperlinked.
  • id 634986: Removed double definition of docParamName in compound.xsd.
  • id 635198: C++/CLI Finalizer methods were not parsed properly.
  • id 636475: Objective-C method names can now be used as the the first argument of \ref.
  • id 636588: Fixed a couple of problems in the compound.xsd schema used for XML output.
  • id 636598: DISTRIBUTE_GROUP_DOC now works again for enum values.
  • id 636947: Improved matching of typedef'ed array parameter and non typedef'ed array parameter.
  • id 637610: Added a number of fixed for Fortran interfaces.
  • id 637712: Handle files with the .for extension as Fortran.
  • id 637987: Fixed error in the grouping documentation.
  • Fixed line number sync problem when using Objective-C #import statements.
  • Fixed problem handling /** @cond */ in the preprocessor.
  • Member groups could get reordered in the output.

Doxygen Release 1.7.2

(release date 09-10-2010)

Changes

  • Changed the default font of the LaTeX output to helvetica.
  • Changed the way parameters and return values are represented in the LaTeX and RTF output. They are now listed using tables.

New features

  • added support for Apple's block object extension for C/Obj-C/C++.
  • added support for detecting Python constructors and destructors.
  • id 624575: Added \endinternal command that can be used to force the end of a section started with \internal.
  • id 552605: Added parsing support for PHP 5.3+ style namespaces.
  • id 582532: added \mscfile command which can be used to insert a message sequence chart given a .msc file. Also added a new config option MSCFILE_DIRS to provide directories were msc files are searched (Thanks to Adrien for the patch).
  • Added support for type specifiers for documenting PHP parameters, format: "@param type $paramname docs"
  • Added support for rendering formulas in the HTML output using MathJax instead of using prerendered bitmaps. For this purpose the options USE_MATHJAX and MATHJAX_RELPATH were added.

Bug fixes

  • id 306076: Fixed case where using of a namespace did not work inside an example.
  • id 336053,487871: /// were not stripped from formulas and \dot..\enddot
  • id 563698: dropped support for a4wide paper format for LaTeX, since it is on the LaTeX taboo list.
  • id 571014: Behaviour of CLASS_DIAGRAM=NO in combination with HAVE_DOT=YES, was not propely documented.
  • id 576291: Python comments for next class or method could end up in code of a method/class when enabling INLINE_SOURCES.
  • id 611174: Fixed problem handling nestes classes in Python.
  • id 621733: removed unexpected warnings about undocumented return types
  • id 622737: Undefined function macros could cause constant expression errors.
  • id 622780: updated copyright statement in PDF docs.
  • id 622935: C# generics appeared with -g extension in the output in some situations.
  • id 623023: Fixed parsing problem for "int &foo1(),&foo2();"
  • id 623052: Link to destructor was wrong in the member index.
  • id 623424: Fixed problem where struct description gets added to variable of struct type.
  • id 623673: Anchors were missing in the Qhp index for members.
  • id 623733: Fixed potential crash due to uninitialized line number.
  • id 623765: closed.png was wrongly linked when GENERATE_SUBDIRS and HTML_DYNAMIC_SECTIONS were enabled.
  • id 624014: Function macro was not handled properly when there was a line continuation directly after the name.
  • id 624095: Linking to a class via a tag file did not work if the class was in an undocumented namespace.
  • id 624104: Fixed a couple of typos in lodepng.h
  • id 624323: Graph legend image was missing form the index files.
  • Fixed a number of typos in the config file documentation (thanks to Jens Schweikhardt)
  • id 624514: Some enums were not cross-referenced.
  • id 624829: Missing \endcond could cause preprocessor issues in next file(s) to be parsed.
  • id 625070: a function definition in a namespace, documented in the header did not always get cross-referenced.
  • id 625296: Removed superfluous <td></td> from parameter list in HTML output.
  • id 625317: Unterminated comment could crash doxygen.
  • id 625531: Inherited documentation was only included for the last derived class in case of multiple inheritance.
  • id 625578: In the HTML output </div> was missing for built-in class diagrams.
  • id 625555: References in example files with underscores were wrong.
  • id 625982: When using japanese characters mixed with ascii characters doxygen incorrected ended the brief description with a dot.
  • id 625952: setting MULTILINE_CPP_IS_BRIEF to YES, cause /// to appear in the output.
  • id 626033,567774: EXTENSION_MAPPING did not work if a the mapped language was handled by the same parser as used for the original extension.
  • id 626175: Fixed bracket bug in LaTeX fancy headers.
  • id 626508: Allow hyphen in key argument of \xrefitem.
  • id 626647: \copydoc did not work for array type arguments (e.g. int[]).
  • Use \dotfile did not produce the correct map file, so URLs in dot files did not work.
  • id 627371: #define's in files only found via INCLUDE_PATH were not correctly handled.
  • id 628065: auto brief description ending with .) cause the ) to end up in the detailed part.
  • id 628242: Fixed encoding issue for the Spanish translation.
  • id 628678: Fixed segmentation fault in case of very long errors.
  • id 629040: Fixed type in search page of the documentation.
  • id 629182: Fixed problem detecting include guard.
  • id 629270: Made file extension to parser mapping case insensitive.
  • id 629485: Latex makefile clean target used rm command also for Windows.
  • id 629942: the EXCLUDE_SYMBOLS option was missing form the online docs.
  • id 631094: \htmlinclude and \verbinclude ended the brief description.
  • id 631380: Inconsistent behaviour when a brief description was given following by a detailed comment block with JAVADOC_AUTOBRIEF enabled.
  • Fixed a number of typos in the documentation (thanks to Albert van der Meer)
  • Fixed potential hangup when scanning directories defined as symlinks to absolute paths.
  • HTML attributes other than src were not copied for the <img> tag.

Doxygen Release 1.7.1

(release date 25-06-2010)

Changes

  • id 621695: Made warning and error messages appear with lower case "warning:" and "error:" prefix to make it easier to use the messages from Visual Studio.

New features

  • id 621908: Added new config option FORMULA_TRANSPARENT which allows selecting between transparent (YES) or non-transparent (NO) PNGs for formulas in the HTML output.
  • Update for Turkish translation.

Bug fixes

  • id 533821: Inheritance relation for a C# class deriving from a generic class was not handled correctly.
  • id 554638: Changing DOT_IMAGE_FORMAT did not cause the graphs to be regenerated.
  • id 576533: A field of the form "enum E *p" was ignore.
  • id 597016: Hide scope name was not working properly for todo items inside class members, where the class was inside a namespace.
  • id 617761: In dot graphs now also @ref worked (previously only \ref was supported).
  • id 621653: Fixed error when compiling doxygen for Solaris 8.
  • id 621733: Removed bogus warning about undocument return type for define when WARN_NO_PARAMDOC was enabled.
  • id 621780: Fixed parsing support for a function that returns a struct definition.
  • id 621785: Doxygen could hang when using \copydoc in a function with \param.
  • id 621805: Using //!< after a #define no longer worked.
  • id 621854,622219,622593: html help compiler (and also the Qt help compiler) was called before all dot images were generated.
  • id 621984: Using a auto-list in combination with \subpage cause the items to be inlined.
  • id 622018: Fixed problem parsing a @param command where the text part started with a formula.
  • id 622019: Added some instructions how to document Fortran code.
  • id 622041: Using \var multiple times in a comment block did not work properly.
  • id 622413: Tooltips could get wrongly truncated when multi-byte UTF-8 characters were used.
  • id 622471: Argument matching failed for typedef in another namespace.
  • Fixed crash situation while handling commands inside a @ref section.
  • Treeview icons were missing in the HTML output when setting GENERATE_TREEVIEW to NO and USE_INLINE_TREES to YES.

Doxygen Release 1.7.0

(release date 15-06-2010)

Changes

  • Changed the look of the HTML output.
  • Made several internal changes that should have a positive effect on the overall performance.

New features

  • The color of the HTML output can now easily be adjusted using three new options: HTML_COLORSTYLE_HUE, HTML_COLORSTYLE_SAT, and HTML_COLORSTYLE_GAMMA, which control respectively the hue, saturation, and gamma of all elements in the HTML output.
  • Moved dot invocations to the end of a doxygen run. Doxygen will now run multiple instances of dot in parallel (for better CPU utilisation on multi-core systems). The new config option DOT_NUM_THREADS determines the number of threads used (were 0 is auto-detect).
  • Added option EXT_LINKS_IN_WINDOW which controls whether or not links to symbols imported via tag files will be opened in a new window.
  • Included various language updates (thanks to Petr for coordinating).
  • Included patch by Stefan Oberhumer that allows customizing the way parameter lists are shown in the LaTeX output.

Bug fixes

  • id 306076: source browser could miss links for used namespaces.
  • id 361476,620924: \if and \endif did not work properly inside auto lists.
  • id 557164: No warning for missing return type documentation even though WARN_NO_PARAMDOC was set to YES.
  • id 577005: Handling of nesting \defgroup's was not always working properly.
  • id 578739: ø was not translated correctly in the LaTeX output.
  • id 583526: Use relative paths for mscgen diagrams to avoid errors in the LaTeX output.
  • id 592991: The "Use current settings at startup" feature of Doxywizard was broken.
  • id 593679: Links in the search results were broken if they pointed to symbols imported via tag files using an absolute path or URL.
  • id 593760,615682: Fixed man page output problem when using @par.
  • id 594021: A C comment before a #endif caused the preprocessor statement to be ignored.
  • id 597013: When HIDE_SCOPE_NAMES was enabled also the scope for nested classes was stripped. Now only the namespace scope will be stripped as before.
  • id 600829: Autolinks to namespace members did not work if an explicit # or :: was used.
  • id 602732: Slashes inside strings in java annotations were not handled properly.
  • id 606335: Fixed the "show html output" button in doxywizard for Windows when IE was set as the default browser.
  • id 608292: Formatting was lost for section copied with \copydoc.
  • id 608359: Fixed C++ parse issue for "class : public base {} var;" construct.
  • id 611056: Generated HTML footer file did not have UTF-8 encoding and the relative path marker needed when using CREATE_SUBDIRS = YES.
  • id 611193: Fixed parsing problem with try-functions having multiple catch handlers.
  • id 611642: Specialized private template member function appeared as public.
  • id 611888: Include dependency graphs were sometimes wrong.
  • id 612170: Some lines in the generated Doxyfile where too long.
  • id 612275: Fixed auto-link problem for certain URLs.
  • id 612292: Improved handling of ellipsis inside brief description when JAVADOC_AUTOBRIEF is enabled.
  • id 612364: Accessibility of macros was not handled properly in all cases.
  • id 612310: Enabling REFERENCED_BY_RELATION without SOURCE_BROWSER could result in broken links.
  • id 612458: Fixed problem handling @copydoc for function operators.
  • id 612609: A raw C# string constant could end up in the next string.
  • id 612969: subpages were not part of the XML output.
  • id 613024: First list item in the paragraph after a @todo item was not parsed properly.
  • id 614204: Generated man page links were having a heading underscore.
  • id 614443: Made include guard detect a bit more strict to avoid false positives.
  • id 614447: The labels of CVS tags were missing a colon.
  • id 614438: Fixed problem parsing Q_PROPERTY with template type and spaces.
  • id 615165: Made the date string in the HTML footer translatable, along with some other sentences on the directory pages.
  • id 612858: Inline attribute was shown also for non-inline template members.
  • id 615583: Fixed problem handling @copy for operators with const qualifier.
  • id 615755: Fixed problem handling '"' inside comments.
  • id 615957: Made the LaTeX output a bit less spatious using \input.
  • id 615695: Fixed preprocessor issue where a macro that was redefined was not resolved.
  • Fixed character encoding issue on the search results page.
  • id 615670: C# namespaces are now extracted also without comment block (the language spec does not allow XML documentation).
  • id 616209: included patch that fixes some typos in the code.
  • id 616344,610604: Pages with an underscore in the label generated a file name containing two underscores.
  • id 616387: text of the form something.symbol got autolinked when symbol had a global scope.
  • id 616761: Call graph could be wrong when local variable has the same name as a global function.
  • id 616947: Added documentation patch on how to create URL links with custom text.
  • id 616988: Doxywizard now removes non-existant files from the recent list and has an option to clear the list completely.
  • id 617051: A macro defined via PREDEFINED did not always overrule a macro definition in the code.
  • id 617278: Enabling call graphs produced invalid XHTML output.
  • id 617871: Non ascii characters in file or directory names caused problems on Windows.
  • id 618079: An ALIAS with parameters spanning multiple lines caused problems with /// style comments.
  • id 618632: Included patch to prevent image overflowing the page in the LaTeX output.
  • id 619728: Fixed problem using EXTENSION_MAPPING for C# (thanks to Vsevolod Kukol for the patch).
  • id 619978: Links to external files could be wrong when CREATE_SUBDIR was enabled.
  • id 620229: /* characters in a print broke parsing within an conditional section.
  • id 620926: \if and \endif did not work properly inside HTML tables.
  • Using @include in combination with LATEX_SOURCE_CODE caused wrong output.
  • Included a patch by Guido Tack which adds two new options for docsets (DOCSET_PUBLISHER_ID and DOCSET_PUBLISHER_NAME) and fixes an issue with linking to docset members.
  • Included patch by Stefan Oberhumer to support escaped {}'s in alias definition and parameters.

Doxygen Release 1.6.3

(release date 21-02-2010)

New features

  • id 608480: Using \dir without argument will create directory documentation for the directory in which the \dir command was found.

Bug fixes

  • id 590161: perlmod output was wrong when using paragraph commands.
  • id 600525: Included patch for VHDL.
  • id 605698: Replaced size attribute of hr tag by class attribute in the HTML output.
  • id 606030,606192,607563: Using \dot produced "Error opening map file" or could even crash doxygen.
  • id 606084: Loading a new config file in doxywizard did not reset all values of a previously loaded config file.
  • id 606104: Grouped members with todo-like items were shown with "GlobalScope" prefix.
  • id 606156: Fixed RTF rendering problem with group index.
  • id 606206,610133: Added missing line break in LaTeX output.
  • id 606330, 608056: The title of pages whose label had an underscore was not shown
  • id 606717: Include guard not starting with #ifndef SOME_GUARD_H were not recognised as such.
  • id 606718: Setting SEARCHENGINE to YES and GENERATE_HTML to NO caused error that search results directory could not be created.
  • id 606772,608493: typedef'ed enums or struct with the same as the typedef did no longer show up.
  • id 607088,607946: Related pages (manual and automatic like the todo page) caused broken links when SHORT_NAMES was enabled.
  • id 607432,608002: Automatically generated related pages (like the todo page) caused broken links when CREATE_SUBDIR was enabled.
  • id 607736: comments after #if could cause next function call not to be cross-referenced.
  • id 607743: \internal inside a conditional section caused warning.
  • id 608016: Using \internal inside a \section did not end at the next \section as documented.
  • id 608018: \internal command produced message with .: in the LaTeX output.
  • id 608072: HTML Tables with custom attributes were not rendered properly.
  • id 608227: Man pages with underscore got double underscore in the name.
  • id 608590: Buffer overflow when using non-ascii characters as class name.
  • id 608921: Macro definition had effect even if the definition was not actually included.
  • id 609504: config.h and config.l where missing from the SVN repository.
  • id 609624: Todo items were merged for overloaded functions.
  • id 609709: C# enum values with @todo items were missing from the todo list.
  • id 610437: Removed bogus warning when using <br/> tag.
  • Fixed parsing problem for function pointer type starting with "typedef enum".
  • Preprocessor did not take EXCLUDE_PATTERNS into account, which could cause parse issues when importing a .tlb file.

Doxygen Release 1.6.2

(release date 30-12-2009)

Changes

  • id 594787: Autolinking to all-lower case words has been disabled, in accordance with the documentation.
  • id 604543: Doxygen now allows any extension supported by dot via the DOT_IMAGE_FORMAT option.
  • Switched back to using PNGs for built-in diagrams and formulas using the Lode Vandevenne's PNG encoder.

New features

Bug fixes

  • Doxywizard did not warn when it failed to save its config file.
  • id 557035: Empty class definitions were not included in Tokens file for docsets.
  • id 563233: GENERATE_QHP details was considered even though it is not defined.
  • id 567346: Comment parser could get stuck in certain cases.
  • id 570369: GENERATE_QHP should generate keywords for classes in generated *.qhc.
  • id 571964: Fixed two issues in the compound.xsd schema definition.
  • id 592991: Fixed wrong default destination directory.
  • id 593040: Fixed problem with distributing member group documentation for anonymous member groups.
  • id 593273: GENERATE_TODOLIST=NO and friends not longer worked.
  • id 593928: Added support for UCS-2 encoded input files.
  • id 594391: Fixed problem parsing fully-qualified java annotations.
  • id 594592,596815: Fixed problem handling quotes.
  • id 595191: Not all configuration options appeared in the index of the documentation and some were not sorted correctly.
  • id 595253: formulas had the .png extension while they were gifs.
  • id 595833: Fixed recursive lockup while resolving template relations.
  • id 595935: Doxygen's preprocessor got confused when /**/ appeared as part of a macro definition.
  • id 596085: Removed obsolete option USE_WINDOWS_ENCODING from the docs.
  • id 596233: RTF output was missing a new paragraph for brief member descriptions.
  • id 596807,596819: Code reformatting done for the LaTeX output could break multibyte UTF-8 characters causing invalid output.
  • id 596809: Using multibyte characters in a page label caused invalid output.
  • id 596816: Documented the interaction between LATEX_CMD_NAME and USE_PDFLATEX.
  • id 597015: Todo items for two inner classes with the same name where collapsed together in the todo list when HIDE_SCOPE_NAMES was enabled.
  • id 597016: Scope was not hidden for members in the todo list even though HIDE_SCOPE_NAMES was set to YES.
  • id 598497: Struct variable with explicit struct keyword got labelled with [read] attribute.
  • id 596902: PHP was not parsed properly when it appeared in a <script language="php"> section.
  • id 597415: Fixed problem matching base class member against the member in the derived class.
  • id 597518: Makefile for Docsets now honors DESTDIR.
  • id 598298: Made browsing for HHC_LOCATION via the wizard yield an absolute path.
  • id 599128: Changed default for CHM_INDEX_ENCODING to CP1250 to avoid issues in a Solaris environment.
  • id 595931: Removed unnecessary paragraphs from HTML table cells.
  • id 597541: referring to page labels of the form a-1 did not work.
  • id 599224: Code generators could produce extra </span> tags.
  • id 599974: Included the PHP search engine again (with new config option SERVER_BASED_SEARCH to enable it)
  • id 600544: Doxygen produced invalid Latex output for RCS tags.
  • id 600563: Fixed issue with include dependency tracking that could cause macro expansion not to work properly.
  • id 600940: Fixed issue with VHDL call graph (thank to Martin Kreis for the fix).
  • id 601138: Fixed problem parsing C++ function-try-blocks.
  • id 601222: #include inside a class could cause line numbers to be off.
  • id 601223: Fixed parsing problem skipping over /**/ comment.
  • id 601694: Fixed problem handling Javadoc style {@code ... } blocks.
  • id 601771: Special commands did not work in the title of the @mainpage.
  • id 602818: Fixed problem parsing files that start with UTF-8 BOM.
  • id 603001: Fixed problem parsing friend function with explicit scope.
  • id 603238: Fixed perlmod generation issue.
  • id 604948: Project number was not centered anymore in the HTML output.
  • id 604503: Using %word in a page title incorrectly did show the %.

Doxygen Release 1.6.1

(release date 25-08-2009)

Bug fixes

  • Fixed file handle leak when parsing include files. Also fixed the logic that determines whether or not an include file need to be parsed.
  • Search result pages were not using UTF-8 character encoding.
  • Search results pointing to external references were not linked correctly.
  • id 133418: Multiline second argument of \ref caused unexpected " warning.
  • id 592454: Feeding invalid XML could crash doxygen's DBus XML parser.
  • id 592485: Include patch to fix problem with building rpms.
  • id 592511,592625: Doxywizard problem with GENERATE_TREEVIEW.
  • id 592650: SHOW_USED_FILES now works again.
  • id 592808: xrefitems (like @todo) did not appear in the list when found in comments marked with @enum or @name.

Doxygen Release 1.6.0

(release date 20-08-2009)

Changes

  • id 580924, 541234: Replaced the PHP based search engine by a Javascript/DHTML based one. As a result the search feature no longer requires a HTTP server with PHP enabled to be usable. Searching is limited to symbols though, but it is now possible to filter on symbol type.
  • id 519886: Make the HTML output XHTML 1.0 compliant.
  • id 579950: Objective-C categories are now merged with their base class, unless there is no base class.
  • Member groups with the same header within the same scope are now merged. This also works for Objective-C categories.
  • Changed the LaTeX style sheet such that more of the markup is configurable. Please update your style sheet if you use a custom one.
  • id 584844: Treat \details inside a brief description as a new paragraph command.
  • Split GENERATE_TREEVIEW into two separate options: GENERATE_TREEVIEW and USE_INLINE_TREES.
  • Removed the dependencies on libpng and libz, doxygen now generates gifs again for internal class diagrams (like it did 7 years ago ;-)

New features

  • Added option SORT_MEMBERS_CTORS_1ST, which when enabled places the constructors and destructors first in an otherwise sorted list.
  • id 581518: Applied patch by Tobias Hunger that adds support for documenting DBus XML interface descriptions.
  • Included QtHelp patch by Karsten Heimrich which adds missing reference and keyword for methods.
  • Included updates for the Korean and Polish translation.

Bug fixes

  • id 131989: Fixed preprocessor handling for C# code.
  • id 133418: -- was not rendered correctly for LaTeX output
  • id 157485: Missing link in todo page.
  • id 318061: Two template functions that only differed in the number of template arguments were seen as the same function.
  • id 443939: HIDE_UNDOC_CLASSES did not work properly.
  • id 509348: Fixed problem with syncing the information of declaration and definition in the presence of an extra forward declaration in the source code.
  • id 522193: For C# enum values were merged together if the same enum name was used in different scopes.
  • id 523167: Included patch to handle PROGRAM statement in Fortran as subroutines/functions.
  • id 554636: Remove spacing around brackets for Obj-C protocols.
  • id 557026: Included patch for fixing wrongly labeled items in docsets.
  • id 560512: Improved parser to better disambiguate nested templates ending with >> from the bitshift right operator.
  • id 570238: Fixed matching problem for method in nested class, where the outer class is a template.
  • id 581746: Segfault/realloc error when a very long path was used.
  • id 582469: documented #define with guard caused wrong documentation.
  • id 582276: Doxywizard could crash on exit in some cases.
  • id 582676: Regression: a struct ivar in ObjC class screws up method identification.
  • id 583213: Included patch that avoids trailing spaces in the generated Doxyfile template.
  • id 584192: Included VHDL patch by Martin Klein
  • id 585543: Fixed case where matching declaration and definition did not work correctly.
  • id 585260: The "more..." link for files was broken, since the anchor was not generated.
  • id 586925: Fixed parsing problem when an unpaired apostrophe appeared in a Python comment.
  • id 588291: Included fix for doxywizard makefile.
  • id 588587: Added missing virtual destructor to CompAccept base class.
  • id 588968: Fixed segmentation fault for specific case in PHP code.
  • Fixed some issues building for Windows.
  • id 589514: Fixed problem handling strings like a"\b" within a comment.
  • id 589616: Fixed problem matching explicitly scoped parameter in a template class.
  • id 590712: A namespaced with name "internal" (C++/CLI keyword) could confuse doxygen's C++ parser.
  • id 591749: @optional/@required attributes for Objective-C were missing from the XML output.

Doxygen Release 1.5.9

(release date 30-04-2009)

New features

  • Added new option LATEX_SOURCE_CODE, which when enabled adds source code also to the latex output (typically to be used in combination with SOURCE_BROWSER)
  • Included updates for the Finnish, Romanian, Korean, German, Japanese, and Hongarian translation.
  • Added translation support for Esperanto.
  • id 579630: Added class attribute to the \todo and \bug HTML code so they can be customized via CSS.
  • id 578740: Added support for Æ and æ characters.

Bug fixes

  • id 395169: Some links via tagfiles were not correct in combination with CREATE_SUBDIRS=YES
  • id 539080: Having the same comment for the declaration and definition of a function could result in duplicate documentation in case the indentation level was different.
  • id 566713: Dot font was not removed even though DOT_CLEANUP was YES.
  • id 566925: Fixed problem resolving symbolic links.
  • id 567044: Fully qualified name was not shown correctly for nested classes.
  • id 567375: Fixed parse problem for typedefs with redundant braces.
  • id 567535: Fixed problem when parsing operator%= for CLI/C++ code.
  • id 567777: Fixed problem with latex output when using enums.
  • id 567990: Doxygen could crash when there was a symlink in project.
  • id 568237: Non-ascii values entered where not saved according to the INPUT_ENCODING.
  • id 568505: Fixed build problem for old Linux distributions.
  • id 569478: Fixed line continuation issue with the Fortran parser.
  • id 570960: C++ class defined in a .mm file was sometimes parsed as Objective-C code.
  • id 571013: In the wizard, editing a text field in the middle of the text in the expert tab caused the cursor to jump to the end of the line.
  • id 571096: Fixed Objective-C parsing problem when multiple protocol forward declarations are put on one line.
  • id 571990: Fixed compiler issue with portable_iconv by moving the function to a C file.
  • id 572560: Fixed parse issue when a #define is inside an enum.
  • id 572740: Fixed problem parsing C++ comments using line continuation.
  • id 573057: Included update for Swedish translator and changed the language code from SE to SV to comply with ISO 639.
  • id 578382: When referring to a static variable or function doxygen will now look at the file context in case of ambiguity.

Doxygen Release 1.5.8

(release date 27-12-2008)

Changes

  • Completely rewrote the doxywizard. Main changes:
    • It is now based on Qt version 4. (4.3 or higher is required)
    • Different layout that allows easy switching between wizard and expert mode, without losing settings.
    • Running doxygen can be done without first having to save the configuration file.
    • For HTML output, there is a button to show the results in the default browser.
    • Option to change the default configuration that is used when you first start the wizard.
    • Non-default options are shown with red label, and there is context menu to reset them back to the default.
  • Included Qt help update by Sebastian Pipping introducing three new options to define custom filter sections and attributes: QHP_CUST_FILTER_NAME, QHP_CUST_FILTER_ATTRS, QHP_SECT_FILTER_ATTRS. Doxygen now directly generates the indices needed by the qthelpgenerator. Qt customers can have a look at issue 28 of the Qt Quarterly for more information.

New features

  • id 131496, 522488, 541649, 554800: Add new option EXTENSION_MAPPING, which can be used to change the mapping of file extension to language parser, e.g. defining EXTENSION_MAPPING = f=C will make doxygen parse files with the .f extension as if it were C files.
  • Added support for Vietnamese (thanks to Dang Minh Tuan)
  • Thanks to Emin Ilker Cetinbas doxygen can now also produce Turkish documentation.
  • id 143218: It is now possible to add the direction attributes normally used with the @param command to document parameters inline, e.g.
           void foo(int v /**< [in] input parameter docs */);
           

Bug fixes

  • TYPEDEF_HIDES_STRUCT did not work correctly if the typedef did a forward declaration of the struct/union.
  • id 153222: Fixed issue following recursive symbolic links.
  • id 423223: Detailed description was not visible for group functions when SEPARATE_MEMBER_PAGES was enabled.
  • id 437346: Fixed issue handling multibyte characters in the RTF output.
  • id 475377: Improved error handling in case of character encoding problems.
  • id 486747: Inherited typedefs were not resolved propertly.
  • id 508752: Add support for BLOCK DATA to the fortran parser.
  • id 532695: included documentation update about the use of \public and friends for object-oriented programming in C.
  • id 532808: References to class variables in PHP code did not already work.
  • id 536394: Warning "no matching file member found" was given for a static variables in multiple anonymous namespaces.
  • id 537686: Fixed invalid empty section for enum in a member group.
  • id 539590: C# generics with the same name but different template parameters where merged.
  • id 540321: A using declaration in a header file was not taken into account in the source file that included it.
  • id 540520: Have two C# enum values with the same name in different enums was not handled properly.
  • id 543036: //## comments were extracted even if they were not part of Rose documentation.
  • id 547436: Fixed issue combining Python docstrings and doxygen comments.
  • id 551615: A multiline C# comment with @ was not shown correctly in the source browser.
  • id 544598: A multiline comment as part of a #define could case wrong line counting and missing cross-references.
  • id 545128: \overload didn't work if it was the last statement in a comment and not followed by a newline.
  • id 553380: Removed bogus warning refering to a namespace member from with a brief description that was converted to a tooltip.
  • id 553968: Added support for JavaDoc command {@code ... }
  • id 554444: Bullet lists were no longer correctly indented when using IE6.
  • id 554674: Fixed index rendering bug in the RTF output.
  • id 555174: The .qch file didn't include generated images.
  • id 555200: Fixed potential crash bug when parsing special comment inside an if at global scope level of a PHP code fragment.
  • id 556240: Tree view in HTML output was not encoded correctly.
  • id 557001: VHDL Parser got confused when -- is in a string literal.
  • id 557014: Undocumented VHDL record member's internal record prefix was not removed.
  • id 557026: Obj-C Protocols and interfaces had wrong type/name in DocSets.
  • id 557031: Obj-C methods no longer require a space after the initial - or +.
  • id 557034: Fixed problem parsing property in Objective-C code.
  • id 557038: Items in tabs.css could not be overridden by custom style sheet.
  • id 557419: $relpath$ was no longer expanded in custom HTML headers.
  • id 557735: Summary for member groups was missing for groups and files.
  • id 558078: collaboration graph of a class using std::list of another class was not correct if the classes where inside a namespace.
  • id 558460: When using \subpage, any section in the sub page was missing from the LaTeX output.
  • id 558525: Template classes produced invalid HTML in the tree view.
  • id 559338: PHP Parser could get confused when there was a comment inside an array initializer.
  • id 559650: Obj-C @interface without body was handle correctly.
  • id 560623: Mixin template classes where not shown properly in the inheritance diagram if the classes where inside a namespace.
  • id 563136: The brief sentence is not shown for groups with no children.
  • id 563384: call graphs were not generated for Qt signals and slots
  • Included VHDL fix by Martin Kreis.
  • grouping of multiple @todo's (and friends) didn't work anymore, causing duplicate sections and labels.
  • Some issues related to the Qt help output were fixed.

Doxygen Release 1.5.7.1

(release date 5-10-2008)

Changes

  • The dot tool is no longer part of the doxygen package for MacOSX. Please install GraphViz separately and set the dot path to /usr/local/bin

New features

  • Added option DOT_FONTSIZE which allows to set the size of the fonts used in dot generated graphs.

Bug fixes

  • id 554432: Re-added ALPHABETICAL_INDEX option.
  • id 554379: Fixed internal error for GENERATE_INDEXLOG when GENERATE_HTML was set to NO.
  • id 554546: Included fix for handling relative includes in the preprocessor.
  • Included several VHDL fixes related to syntax highlighting, finding class members, and mixing upper and lower case.
  • Included patch to allow setting DEST_DIR environment variable to determine where to install doxygen.

Doxygen Release 1.5.7

(release date 28-9-2008)

Changes

  • The default CSS style sheet has been cleaned up and simplified, thanks to the work done by Quinn Taylor.

New features

Bug fixes

  • id 140264, 332187, 541924: Sections inside a \subpage where not shown as subsection in the LaTeX/RTF output.
  • id 155098,156188: Added support for UTF-8 special characters in identifiers (which is allowed by e.g. C#).
  • id 304598: operator-- caused invalid HTML output.
  • id 324047: parameter type [in or out] were not generated in RTF document
  • id 363499: @todo and friends did not work in a comment marked with @dir.
  • id 445485: HTML commands in a comment block with attribute values without quotes were not handled properly.
  • id 533855: Processes were always documented as anonymous in VHDL code.
  • id 535379: Added support for %{...%} blocks in XPCOM's IDL.
  • id 536298: Last port in a VHDL port list was not correctly put in a member group.
  • id 536385: Fixed problem matching function prototype and implementation under certain conditions.
  • id 536629: Fixed compilation issue on NetBSD.
  • id 537393: Properties in Python were not properly handled.
  • id 538065: Added support for @optional and @required in Objective C 2.0 protocols.
  • id 538239: Some unlabeled VHDL processes were not corrected detected.
  • id 538515: Deriving a Objective-C interface from a protocol caused parsing problems if the interface also has a body.
  • id 539057: Part of an Objective-C expression could be missing in the source browser under certain conditions.
  • id 539590: Generic C# classes with the same name but different template arguments were no longer treated as different classes.
  • id 539712: Fixed code parser issue for parameter indices of procedures and functions.
  • id 540058: Creator code was wrong in the MacOSX application bundle.
  • id 540372: Fixed problem parsing large table by increasing YY_READ_BUF_SIZE in the generated parser files.
  • id 540247: Fixed potential memory corruption issue parsing VHDL.
  • id 541113: Fixed locale for ctype, to avoid stripping of 0xA0 from multi-byte UTF-8 characters.
  • id 544479: SORT_MEMBER_DOCS did not work for class members.
  • id 546621: Fixed makefile so that .svn stuff is removed from the tarball when doing "make archive".
  • id 546812: Using a table with row span greater than 1 did not produce correct LaTeX output.
  • id 545098: Fixed problem parsing where clauses in combination with C# generics.
  • id 545503: Nameless parameters of type "struct A" could end up wrongly in the XML output.
  • id 545970: Refering to the main page did not work as advertised.
  • id 546158: The variable defined inside a foreach statement in C# code was not considered for source linking, cause potentially incomplete call graphs.
  • id 547361: Linking to specialized template functions did not work.
  • id 548175: Fixed problem parsing class members within a class X, inside a namespace that is also named X.
  • id 548443: Documenting a nested namespace/classes with @namespace X.Y did not work for C# (only X::Y worked).
  • id 548489: C++/CLI classes of type sealed abstract were not processed correctly.
  • id 549318: Some headings in the user manual where wrongly formatted.
  • id 549581: Fixed potential buffer overflow in preprocessor.
  • id 550058: Obj-C: properties for private fields did not appear in the output unless EXTRACT_PRIVATE was enabled.
  • id 550156: Corrected typo in the documentation for GENERATE_TREEVIEW.
  • id 550247: Fixed problem parsing octal character literals in the preprocessing phase.
  • id 551739: Related function with explicit namespace scope was not properly placed if the function also existed in the global namespace.
  • id 552115: Anonymous structs and unions could produce invalid links in the html help index.
  • id 552361: Fixed problem with operators in the LaTeX output.
  • id 552600: \copybrief ended a brief description instead of appending to it.
  • id 553469: Removed bogus warning about internal inconsistency when importing items via a tagfiles that are inside an undocumented scope.
  • id 553616: One can now remove the automatic line breaks in the type part of a declaration by using a custom stylesheet with BR.typebreak { display: none; }
  • id 553663: Aliases did not work in Fortan comments.
  • id 549022: Reimplemented in links could be wrong in case of overloaded members.
  • id 553225: Parser was confused by arrays inside an Obj-C message.
  • Finnish translation was disabled.
  • A collaboration graph with multiple edge labels with not written to the XML output correctly.
  • sub pages of a \mainpage were not shown in the Latex/RTF output.
  • Included some fixed for the VHDL parser.

Doxygen Release 1.5.6

(release date 18-5-2008)

Changes

  • The GENERATE_TREEVIEW option is not longer a boolean, but can now have 4 values, NONE (was NO), FRAME (was YES), HIERARCHIES, and ALL. Thanks to Jake Colman for the patch.
  • a page marked as a sub page (\subpage) is now shown in the LaTeX and RTF output as a section of its parent page. So the top level pages are shown a chapters, subpages as sections, subpages of a subpage as subsections, etc.
  • Included spec file updates by Kenneth Porter.

New features

  • id 514810: Added DOT_FONTNAME and DOT_FONTPATH options which allow instructing dot to use a different font than FreeSans.ttf which doxygen put in the output directory.
  • id 517242: Added option CHM_INDEX_ENCODING to specify the encoding to be used for the CHM index files. Needed because CHM index files cannot handle UTF-8 encoding.
  • id 519573: Included patch to make the font-size button visible in the CHM output.
  • id 521288: Added new options SHOW_NAMESPACES and SHOW_FILES to Suppress Namepace and Files Pages.
  • id 521495: Included a patch that makes it easy to modify the root of the html treeview with an image using style sheets.
  • id 522300: Added option IDL_PROPERTY_SUPPORT to enable/disable special propget/propput handling in IDL files.
  • Translation support for Finnish has been updated.
  • Added option FORMULA_FONTSIZE which can be used to change the font size of the formulas included in the HTML documentation.
  • included update for Russian translation.
  • included patch to fixed some issues with VHDL code and add support for some VHDL-93 constructs.

Bug fixes

  • Regression: fixed problem handling STL classes when BUILTIN_STL_SUPPORT was enabled
  • id 142866,377976: Added new \copybrief and \copydetails commands, which work as \copydoc but then only copy either the brief or the detailed part of a comment block.
  • id 312655: DISTRIBUTE_GROUP_DOC didn't always work in combination with SORT_BRIEF_DOCS enabled.
  • id 352234: The search index could contain invalid references when SOURCE_BROWSER=NO and CALL_GRAPHS=YES.
  • id 402447: Added support for C# method declarations with where clauses.
  • id 425029: WARN_FORMAT does no longer require all of $file, $line, $text to be valid.
  • id 495687: Replaced MAX_DOT_GRAPH_MAX_NODES with DOT_GRAPH_MAX_NODES in the docs & config file.
  • id 508694 Fixed problem with mixed simple and double quotes in fortran format declaration
  • id 508752: Fixed problem where the fortran scanner didn't recognize END
  • id 510971: Fortran: parser was confused by double REAL() in processed statements.
  • id 514488: Fixed problem matching argument lists with const qualifiers.
  • id 514891: PDF generation failed with a LaTeX error when tocdepth was set to a value higher than 2.
  • id 515518: Links in member group documentation was broken when CREATE_SUBDIRS was enabled.
  • id 516086: Fixed division by zero when producing RTF output for the comment /** <table><tr></tr></table> */
  • id 516536: Fixed build issues on OSX 10.4 and earlier.
  • id 516070: Added support for simple events without accessors in C#.
  • id 516387: replace 0xA0 character in perlmodgen.cpp by a space to avoid compilation problems with the Chinese version of Visual Studio.
  • id 517112: Regression: examples with the same name but different paths cause "file not found" warning.
  • id 518334: Fixed problem parsing Objective-C protocol definitions.
  • id 518537: Hiding an enum with an undocumented typedef with the same name caused explicit referencing of the enum to fail.
  • id 519661: In some cases a function prototype could incorrectly be flagged as a variable with constructor.
  • id 520325: Fixed parse problem when comment was after an extern "C" block and before the opening bracket.
  • id 521234: Fortran: fixed problem causing "stack empty! when parsing code"
  • id 522225: PDF Latex output did not produce proper hyperlinks for \page and \subpage comment blocks.
  • id 522248: Page header were wrongly displayed in the RTF output.
  • id 522415: Fixed compile errors in addon/doxmlparser.
  • id 522600: Added additional warnings to signal invalid configurations.
  • id 523138: Removed redundant paragraph in navigation section of the HTML output.
  • id 523326: Namespace name was prepended twice to template specializations classes.
  • id 524357: Default mentioned for REFERENCED_BY_RELATION relation was not correct.
  • id 524359: Default mentioned for REFERENCES_RELATION relation was not correct.
  • id 524473: Removed incorrect warnings about parameters in VHDL.
  • id 525140: Improved handling of Objective-C 2.0 properties.
  • id 525143: Properties are now listed as attributes in the UML diagrams.
  • id 525144: GENERATE_DOCSET option greyed out in doxywizard.
  • id 526155: Removed warning about QFile::setName when parsing VHDL files.
  • id 527781: Template arguments for bases class not shown in a consistent way.
  • id 528023: Inheritance relations were not correctly displayed for C# generics.
  • id 528424: Fixed rendering bug in HTML output when used with Opera.
  • id 528584: Using enum and enum value with the same name in C# code caused crash.
  • id 528620: Fixed typo in French translation.
  • id 528815: Fixed problem parsing define() statements in PHP code.
  • id 528989: Leading C comment could prevent preprocessor expansion for the rest of the line.
  • id 529803: Doxygen didn't find call(er) relations for C# when using this.Method() calls;
  • id 529554: Putting defined() inside a macro caused the preprocessor to get confused.
  • id 529758: C++/CLI: default inheritance is now public, nested templates ending with >> are now handled properly as well as indexed properties.
  • id 530201: Avoided warning for undocumented self parameter in Python.

Doxygen Release 1.5.5

(release date 10-2-2008)

Changes

  • Pages created with @page are now chapters in the LaTeX and RTF output and treeviews, and directly follow the mainpage. Also the project name is not longer repeated for each chapter. This should make it more convenient to create normal, printable documentation with doxygen.
  • For dot graphs with an edge with more than ten labels, only the first ten are shown followed by an ellipsis; done to prevent very long dot runs resulting in unreadable graphs.
  • Use of pdflatex with hyperlinks is now the default.
  • id 511116: C++ preprocessor macro names are now replaced in the comments as well. For example, S and m are replaced in the comments for: #define C(S,m) /** container S */ struct S { /** value m */ int m; }
  • id 493923: The options SOURCE_BROWSER, CALL_GRAPH, CALLER_GRAPH, REFERENCES_RELATION, and REFERENCED_BY_RELATION can now be indepently enabled and disabled. By default the relations are now disabled.

New features

  • Added support for VHDL (.vhd or .vhdl extension) based on a patch by Martin Kreis. Use OPTIMIZE_OUTPUT_VHDL when parsing VHDL code.
  • id 374699: Added support for Objective-C 2.0 properties.
  • Added compilation support for MacOSX 10.5 (Leopard) incombination with Xcode 3
  • Added support for docsets, which allow integration of doxygen generated API documentation in Xcode 3. new options:
    • GENERATE_DOCSET: enables/disables the feature
    • DOCSET_FEEDNAME: sets the provider/suite name under which the set is listed.
    • DOCSET_BUNDLE_ID: A unique name for the docset.
    See the configuration file or manual for more details.
  • id 493467: Added compilation support 64bit Solaris machines in combination with Sun's own compiler (thanks to Heiko Jansen).
  • id 153376: Added support for the \tparam command, which works similar to \param but is meant for documenting template parameters.
  • id 140104: Added \headerfile command which can be used to specify the second and third argument of a \class command, when the documentation is already in front of a class definition.
  • Added translator support for Macedonian.
  • Added language updates for German, Perian, Spanish, Taiwanese, and Chinese, Korean, Croatian.

Bug fixes

  • Fixed potential crash bug due to wrong pointer check.
  • Using @param as the first word in a comment block did not work properly in combination with JAVADOC_AUTOBRIEF set to YES.
  • Some character's could be missing from IDL properties.
  • Automatic abbreviations did not work for nested classes or classes in a namespace.
  • Fixed a preprocessor bug where the line numbers of a definition could get out of sync with the source code.
  • id 142023: Putting Qt signals or slots in a group did not make them appear in the group documentation.
  • id 318668: Comments in Python function argument lists got messed up.
  • id 325359: Added support for C# XML-doc commands typeparam and typeparamref.
  • id 331674: Aliases did not work in Python code.
  • id 356399: Fixed strange warning when specifying a tag file with an anchor twice.
  • id 363828: Docstrings found at the top of a python file are handled as module documentation again.
  • id 429437: A #include outside the input files was not searched in the current directory of the file containing the include.
  • id 451299: Sometimes the wrong include file chosen when ambiguous
  • id 460585: @cond did not work in Python code.
  • id 477377: Function in undocumented anonymous namespace cause broken link if EXTRACT_ALL was set to NO.
  • id 484731: Additional fixes for parsing Fortran.
  • id 488125: operator->* was not displayed properly in the output.
  • id 490766: Fixed compile error in fortranscanner.l which occurred for some compilers.
  • id 492027: Ampersand (&) in front of parameter stops documenting of PHP source
  • id 493249: using a namespace (or fortran module) caused the namespace to appear in the documentation as if it was defined.
  • id 493434: Nested C# style XML lists in a comment block were not handled correctly.
  • id 494187: Doxygen could crash due to an infinite recursion when using tag files.
  • id 494599: When updating a config file an extra space was added just before the end of a quoted string.
  • id 494760: Putting a # in a path name using Doxywizard, caused the # to interpreted as the start of a comment in the Doxyfile.
  • id 495656: Description of default used for DOT_TRANSPARENT was wrong.
  • id 495687: Fixed typo in the description of DOT_GRAPH_MAX_NODES.
  • id 496392: Putting character entities like é in section/group titles resulted in &acute; in the output.
  • id 498049: Improvements to .spec files for RPM creation.
  • id 498680: Callgraphs for functions in anonymous namespaces generated invalid labels for 'dot' when EXTRACT_ANON_NSPACES was set to YES.
  • id 498711: Reference parameters in PHP were not properly parsed.
  • id 499577: Collaboration diagrams not working with typedef
  • id 500227: Wrong output generated for Objective-C methods with multiple arguments for LaTeX or RTF output.
  • id 500635: Project name is no longer placed before each top level item in the treeview and other indices.
  • id 500465: Fixed some issues compiling for AIX.
  • id 500928: Fixed parser issue handling a tripple quoted string when used to initialize a Python variable.
  • id 500944: Python variables with package scope were only extracted if EXTRACT_STATIC was enabled.
  • id 501704: Line numbering was wrong when a #include was placed inside an array/struct initializer list.
  • id 502213: Combining a brief and detailed description in an alias produced the warning "unknown command \_linebr".
  • id 502447: Single quoted PHP strings were not handled correctly by the source code parser.
  • id 503939: Variable was checked before initialized.
  • id 504120: TYPEDEF_HIDES_STRUCT now also works for enums.
  • id 504439: Assert when marshaling a member which had an associated example.
  • id 504650: Generated LaTeX code injected hyperlinks into section titles.
  • id 507052: Fortran function named x_function was not properly handled.
  • id 507603: Enabling FILTER_SOURCE_FILES caused strange warnings when INPUT_FILTER is empty.
  • id 508740: Using upper case port mode specifiers did not work correctly.
  • id 508753: Fortran: Added .f as allowed fortran extension.
  • id 508759: Fortran: fixed potential memory corruption while scanning parameter lists.
  • id 507528: XML output was not correct for pointer arrays.
  • id 508752: Fortran scanner didn't recognize lonely END
  • id 509278: Spaced before the \internal command where treated as documentation.
  • id 509582: Fortran: Spaces in function return type were not parsed properly.
  • id 510387: Fortran scanner didn't parse initialisation of complex type correctly.
  • id 511921: @file command ended brief description even when JAVADOC_AUTOBRIEF was enabled.
  • id 512620: \copydoc of a comment with @param commands could result in warnings that parameters were not documented.
  • id 513570: Fixed cross site scripting vulnerability in the search.php script.
  • id 514814: Included missing fromUtf8 calls to translator decoder to prevent potential language encoding issues.
  • id 513885: Using this-> inside a function could result in incomplete call graph.

Doxygen Release 1.5.4

(release date 27-10-2007)

Changes

  • id 469260: When setting SOURCE_BROWSER to YES, all undocumented classes also ended up in the documentation. Now this will only happen if EXTRACT_ALL is also enabled.
  • Upgraded included third party libs libpng and zlib to version 1.2.21 and 1.2.3 respectively.

New features

  • Included support for parsing Fortran 90, thanks to a patch by Anke Visser and Oleg Batrashev (source: http://dougdevel.org/index.php?page=doxygen)
  • id 477548: Added config option SIP_SUPPORT to support handling SIP sources (used for Python to C++ bindings).
  • id 475828: Added support for CLI/C++ style indexed properties.
  • Added config option TYPEDEF_HIDES_STRUCT which when enabled treats a typedef of a struct as a struct with the name of the typedef. This behavious was coupled to OPTIMIZE_OUTPUT_FOR_C in the previous version and is now an independent option.
  • Included updates for the Korean, Brazilian and Chinese translations.

Bug fixes

  • id 314541: Fixed wrong DOCTYPE in HTML output when GENERATE_TREEVIEW was set to YES
  • id 321784: Changed scope resolution algorithm to avoid lookup failures on using directives (thanks to Christoph Schulz for the patch).
  • id 415866: Fixed bug in preprocessor causing "More #endif's than #if's found" warning.
  • id 426971,465020: A brief description would in some cases be treated as a detailed one.
  • id 430148: Doxygen reported "Internal Inconsistency" for class member inside anonymous namespaces.
  • id 433449,363010: Removed Internal inconsistency when referencing enum values found in a tag file.
  • id 438282: Line numbers were displayed when using \include inside \example.
  • id 443942,461433: mscgen was not called correctly on Windows when generating .map files.
  • id 457346: increased the threshold for adding line breaks to the type part of a declaration.
  • id 460294: Missing references in source browser when using the "register" keyword.
  • id 461889: Fixed bogus "no matching class member found" case.
  • id 462051: In certain cases doxygen failed to find the proper inheritance relation.
  • id 462077: Error in LaTeX index generation due to unescaped characters.
  • id 462159, 143250: Added support for parsing functions/methods returning a pointer or reference to an array, e.g. a function of the form: "int (*f(int))[];"
  • id 462436: Inheritance from an unknown template class was not handled consistently.
  • id 462439: Adjusted \author documentation.
  • id 462757: Fixed Latex output bug for members of anonymous struct or unions.
  • id 462861: Members references via tagfiles were sometimes broken.
  • id 463139: Doxygen failed to detect duplicate variable declarations in the same file.
  • id 465138: HTML entities in page title (such as ü) where not displayed correctly in the HTML output.
  • id 465170: Wrong line numbers reported for errors when using multiline formulas.
  • id 465172: Fixed issues parsing <code>operator</code>.
  • id 466803: Fixed crash when parsing Java enum with empty field.
  • id 466890: Handling of CVS/RCS keywords was broken.
  • id 466910: When UML_LOOK is set to YES, the graph orientation is always top to bottom.
  • id 466991: Template argument using '?' operator breaks file generation.
  • id 468858,472310: C++ casting operator with templates was displayed wrong.
  • id 468937: .hhc and .hhk was missing the </body> and </html> tags.
  • id 469269: When HTML_DYNAMIC_SECTIONS was enabled, index.hhp missed open.gif and closed.gif.
  • id 470029: Fixed crash while parsing a particular piece of PHP code.
  • id 471185: The word "property" was stripped from functions that started with it.
  • id 471495: Objective C category documentation was ignored in some cases.
  • id 472193: Fixed issue expanding multiple occurrences of the same alias command argument.
  • id 472201: Removed spurious warning introduced by the fix for bug 465170.
  • id 473105: Auto link to nested class inside a base class was missing.
  • id 473140: Anonymous scope ended up wrongly in the XML output.
  • id 473402: context dependent \ref's inside a dot or msc graph did not work anymore.
  • id 473679: Doxygen skipped function if return type contained round parenthesis.
  • id 474529: index entries in LaTeX could be wrong on some platforms.
  • id 476035: Externally referenced links obtained via a tag file had an extra g in the anchor
  • id 476562: argument of copydoc appears in XML output without proper escaping.
  • id 476766: Type of a virtual destructor was "virtual" in the XML output.
  • id 479113: Automatic links were not generated when next word started with "const".
  • id 479762: Wrong character encoding was used for dot files.
  • id 480722: File tooltips incorrect for the include dependency graph.
  • id 481168: Allow \f{environment}{ .... \f} so the number of braces matches.
  • id 481107: Using HTML_FILE_EXTENSION to set a non-default extension did not work for the "no frames" link to main.html when GENERATE_TREEVIEW was enabled.
  • id 481827: Macro expansion removed the @ character when it appear in a C comment.
  • id 482964: The "template" word was a little too close to the rounded border in the html output when rendered by Firefox.
  • id 484277: Adjusted the instructions to report a bug in the hope this will result in less duplicate bugs.
  • id 484731: Fixed issue parsing unindented interface (Fortran).
  • id 486159: Fixed problem parsing \xrefitem commands in joined comment blocks.
  • id 488760: Added support for Trigraphs to doxygen's C-preprocessor.
  • id 488800: Fixed problem in perlmod generation.
  • id 488837: abstract class in PHP was not properly parsed.
  • id 489049: Setting MUTLILINE_CPP_IS_BRIEF to YES could cause wrong line number references.
  • Call graphs were not properly synced between function declaration and definition.
  • Fixed bug in doxygen's internal caching mechanism which could make doxygen forget enum lists for large projects.

Doxygen Release 1.5.3

(release date 27-7-2007)

Changes

  • When OPTIMIZE_OUTPUT_FOR_C is enabled then a struct definition of the form typedef struct _S { ... } S_t will be shown in the output as a struct of type S_t and the typedef itself is omitted (previousily _S was shown as well as a typedef of the form typedef _S S_t).
  • Improved the line-breaking rules for members whose return types have many characters (for example a function returning a pointer to a template class).
  • Multiple brief and detailed descriptions are now possible. It is still not recommended to make use of them, but at least no documentation is silently hidden when there are two brief or two detailed descriptions for the same entity.
  • Improved dot layout control and page sizing to better fit images on the screen and paper.

New features

  • Added support for aliases with arguments, see the manual for more information.
  • Added HTML_DYNAMIC_SECTIONS option which, when enabled, will produce sections in the HTML output that can be expanded/collapsed. Currently used for diagrams and graphs.
  • Added support for type constraints as available in the C# language ("where" clause)
  • id 332263: Added new option EXTRACT_ANON_NSPACES that when set to YES will extract the contents of anonymous namespaces and show then in the output.
  • id 423765: Added support for <see cref="SomeSymbol"/> style XML comments.
  • id 426971: Added QT_AUTOBRIEF config option, which has the same meaning as JAVADOC_AUTOBRIEF only now for /*! .. */ style comment blocks.
  • id 435108: Reintroduced the MAX_DOT_GRAPH_DEPTH option as a means to further reduce the size of a graph.

Bug fixes

  • id 137644: Fixed issue with "const" parsing of a typedef'ed struct where the "const" is placed after the struct definition.
  • id 153362: A typedef of a function pointer was not shown correctly in the output.
  • id 156003: Wrong template arguments when using @related for a (template) function with a template class.
  • id 170004: The check for PDF or DVI in the generated latex output was not always reliable.
  • id 300022: PHP code with unknown extension was parsed as C/C++ code. Added a detection rule for <?php to switch to PHP parsing.
  • id 317967: Setting USE_PDFLATEX to YES now generates a Makefile with a "pdf" target, to be consistent with the documentation.
  • id 397099: Fixed several cases where "referenced by" relation was unresolved.
  • id 423776: XML style see tag resulted in messed up documentation.
  • id 426852: \hideinitializer was sometimes ignored when using structural commands.
  • id 426977: Included a patch allow building under recent versions of Cygwin
  • id 427991: Doxygen failed to call mscgen.exe properly on Win32 platforms.
  • id 430962: struct keyword was stripped from typedefs even for C code.
  • id 431049: Fixed potential crash when GENERATE_PERLMOD was enabled.
  • id 431202, 333607: Quotes inside strings caused the Pythons parser to get off track.
  • id 431763: doxygen crashes when using unsupported tags in the config file.
  • id 432420: Last enum value of a Java 1.5 style enum with constructor did not appear.
  • id 432743: The "std" namespace appeared in the output when BUILTIN_STL_SUPPORT was enabled.
  • id 432757: Setting INLINE_INHERITED_MEMBERS to YES, did not inherit the group of grouped members of a base class.
  • id 433630: Using double-quotes (") inside a brief description could lead to errors in dot files when the brief description was used as a tooltip.
  • id 434079: The number of graph nodes could still be too large despite a conservative DOT_GRAPH_MAX_NODES setting.
  • id 436648: List of class members was no longer complete under certain conditions.
  • id 437218: Special characters in \brief string cause problems HTML/XML in source listings.
  • id 438300: Fixed two cases where doxygen could access memory outside array boundaries under certain conditions.
  • id 441114: Add support for <term> inside <list> to conform to C# XML comments.
  • id 442313: Casing of special commands was not handled consistently.
  • id 443942: Fixed problems running mscgen.
  • id 444823: No newline after the error message when hhc failed with return code >0
  • id 445105: Fixed some issues and wrong spacing for the RTF generation.
  • id 446585: Doxygen could crash when producing a warning for undocumented C++/CLI arguments of the type "T%".
  • id 447133: Replaced occurrences of ' by ' in the HTML output.
  • id 448210: Make rule to install manpages was broken.
  • id 451297: Fixed more issues where using double-quotes (") inside a brief description could lead to errors in dot files when the brief description was used as a tooltip.
  • id 452824: In the source browser linking of a local variable did not work after a sizeof() of the variable.
  • id 452828: Missing reference to struct member in the source browser due to incorrect bracket count.
  • id 453366: Removed bogus warning for unresolved references in brief descriptions.
  • id 453918: The __init__.py files were incorrectly treated as modules causing scoping issues for symbols defined inside such file.
  • id 456471: Changing the installation location (--prefix) did not affect the location were the documentation was installed. --docdir can still be used to overrule the location for the documentation.
  • id 456475: Added support for C++/CLI style finalizers.
  • id 457857: Leading "struct" keyword is no longer stripped from the documentation of functions that return a pointer to a struct.
  • id 458710: Expanding environment variables in the config file to a file or path name with spaces (e.g. "$(VCInstallDir)include") was incorrectly interpreted as a list when used with for instance INPUT.
  • id 458749: Undocumented constructors/destructors inside an undocumented member group were not visible in the output.

Doxygen Release 1.5.2

(release date 4-4-2007)

Changes

  • The options MAX_DOT_GRAPH_WIDTH, MAX_DOT_GRAPH_HEIGHT, and MAX_DOT_GRAPH_DEPTH have been replaced by a single option DOT_GRAPH_MAX_NODES, which can be used to limit the size of a graph indirectly, by specifying the maximum amount of nodes in the graph. The main advantage is that this can be computed much faster; dot has to be run only once per graph and never on graphs with more than the specified amount of nodes. Note that doxygen will always render the root node and its direct children even when DOT_GRAPH_MAX_NODES = 0.
  • Parameters names are now copied to reimplemented functions, avoiding warnings about missing or wrong parameter names when INHERIT_DOCS = YES.

New features

Bug fixes

  • id 132886: Included patch to fix an issue with using a sequence of xrefitems
  • id 134792: Added configure script for Cygwin autodetection.
  • id 162006: Doxygen now uses the default search path of dot for user defined dot graphs (defined with @dot and @dotfile).
  • id 306231: Include fix for Japanese translation.
  • id 315543: htmlinclude didn't work as part of a description of a param.
  • id 322806: Doxygen now does not treat >> in a template list as a shift operator for Java and C#.
  • id 332815: Legend generated with GENERATE_LEGEND did have typo.
  • id 345820: Included patch to make doxygen handle config files with @INCLUDE with absolute paths correctly.
  • id 364780: Included patch to improve scope handling of nested classes/namespaces by the code parser (thanks to Ben Voigt).
  • id 366113: Fixed configure script issue under Solaris.
  • id 367233: Non-class functions were duplicated in the xml index file.
  • id 367495: Windows build files had only support for English by default.
  • id 369499: In some cases variable names were duplicated in python source code output.
  • id 369200: Fixed parse problem when a single quote appeared in a Python comment line.
  • id 373229: Doxygen now gives a warning when it cannot inline a #include inside a body
  • id 374486: Inheriting from a template argument via an intermediate typedef could result in invalid output.
  • id 375073: \ref could cause wrong XML output.
  • id 375753: Added missing new line to error message.
  • id 377911: Fixed problem with end of formula.
  • id 380516: Fixed line number issue in the Python parser.
  • id 381450: Tabs in the HTML output redefined the value of an "id" attribute, which is not legal HTML.
  • id 374592: Member grouping didn't work properly for constructors.
  • id 381608: Initializer values of class variables and constants did no longer appear in the documentations.
  • id 382274: Scanning files with RECURSIVE enabled ignored EXCLUDE_PATTERNS.
  • id 383377: C# code was not passed though the C-preprocessor.
  • id 383493: Improved the warning message for unterminated code/verbatim blocks.
  • id 384439: Made comment block parser more robust against HTML errors.
  • id 385384: SEPARATE_MEMBER_PAGES=YES caused broken links in Html Help index.
  • id 387781: Parsing #import statements was broken for Objective-C.
  • id 387848: Included patch to avoid LaTeX compilation issues.
  • id 389656: For C# enums in the same scope can have the same values, but doxygen's parser got confused.
  • id 389750: Fixed alignment bug in the default html footer generated by doxygen.
  • id 390821: Fixed problem parsing Java 1.5 enums with initializers.
  • id 391619: When dot produces an non-zero return code, doxygen now prints the return code and the command it tried to execute.
  • id 407815: Doxygen's got confused by certain combinations of " and ' s in PHP code.
  • id 409935: Fixed bug in qcstring.cpp
  • id 411300: PDF/Latex output was broken for operator[] documentation.
  • id 411328: Fixed Accessibility/Section 508 Compliance issue.
  • id 413071: Added support for Java 1.5 annotations.
  • id 415683: Two typedefs of function pointers with different names could still resolve to the same type if the only difference was the argument list and as a result cause "Undocumented function" warnings.
  • id 418920: Doxygen stripped leading comment chars from C# code blocks.
  • id 421131: Character encoding was not consistent for all HTML files.
  • The "list of all members" was not shown for a class with no members that derived from a class with members.

Doxygen Release 1.5.1

(release date 29-10-2006)

Bug fixes

  • id 148567: @todo at the end of a comment block caused problem when copied by @copydoc
  • id 352420: Fixed bug in LaTeX output (missing space after \bf).
  • id 363227: missing output for instance variables defined in a Python function that has a doc string
  • id 363397: Member groups did not appear in a class when SUBGROUPING was set to YES.
  • id 364341: Parsing could become really slow if often included header files contained using statements.
  • id 364673: The values of two enums with the same name (both in difference scopes) where merged.
  • The version of dot shipped with the Mac binary had some non-standard dependencies.
  • Doxywizard didn't work on PC's where no Visual Studio 2005 was present, when build with the project files (I'm now using /MT instead of /MD which fixes this issue).
  • Running 2 instances of doxygen on the same output directory caused corruption of the temporary files generated by doxygen.

Doxygen Release 1.5.0

(release date 16-10-2006)

Changes

  • cleaned up the internal structures to make them smaller, and made doxygen use a temporary file to store the parse results (instead of keeping them in memory), which will further reduce the memory usage, especially for large projects, and is a first step towards incremental parsing.

New features

  • Added example application that shows how to configure and run doxygen from within an application and use the information collected by doxygen without also generating the output (see addon/doxyapp).
  • id 322467: Sections produces by \note, \warning, \remarks etc, now have a class label in the generated HTML (<dl> tag) so you can give them a distinct style using a non-default stylesheet (i.e. using HTML_STYLESHEET).
  • Added project files for building doxygen from Visual Studio 2005 (see winbuild dir).
  • added translator updates for Czech, Danish, German, Catalan, Croatian, French, Japanese, and Italian.
  • added translator support for Arabic (thanks to Moaz Reyad)
  • added translator support for Persian (thanks to Ali Nadalizadeh)

Bug fixes

  • id 131445: Fixed autolinking for related functions.
  • id 137236: Updated documentation to make it clear that a lower-case only word is not a candidate for autolinking.
  • id 141758: Fixed a problem parsing <?=...?> contructs outside of functions in PHP.
  • id 319169: Second level index not shown when DISABLE_INDEX=YES.
  • id 325337: Added "optimize output for C#" option to Doxywizard.
  • id 325426: Partial C# class inside a namespace where not handled properly.
  • id 327358: Fixed wrong link to the search engine when CREATE_SUBDIRS was set to YES.
  • id 326885: Leading ///'s ended up in code fragments when using indented /// comments.
  • id 330513: For file documentation, the scope not stripped for namespace members even if HIDE_SCOPE_NAMES was set to YES.
  • id 335131: Fixed "internal inconsistency" warning related to use of nested classes defined outside a used namespace.
  • id 338475: Added support for Q_SIGNALS and Q_SLOTS macros (thanks to Thomas Zander for the patch).
  • id 340973: Improved performance of "Computing template instances" step significantly in case of (large) Java projects.
  • id 342090: Fixed missing cross-reference to "m" for code of the form f(a[s.f]->m)
  • id 344443: Code font commands where not treated properly in C# style comments.
  • id 344445: Made it more clear in the documentation where the XML commands in the comment blocks are for, and how <code> works in C#.
  • id 345322: DOTFONTPATH was corrupted in mingw builds.
  • id 345519: Fixed problem parsing attributes in C#.
  • id 345660: Python class members that spanned multiple lines could confuse the parser.
  • id 345742: enum values were shown twice in some cases.
  • is 346095: Forced a newline before \normalsize in the LaTeX to avoid font size issues.
  • id 346848: Under certain conditions nesting of groups did not work properly.
  • id 347444: paramref XML command did not render properly.
  • id 348259: Doxygen now keeps the _formulas.log file when there is a problem generating bitmaps for formulas. This can help to identify the problem quicker.
  • id 348481: friend class in unnamed namespace produced bogus error.
  • id 348537: Fixed internal inconsistency warning that could occur when reopening an anonymous namespace
  • id 349867: Fixed issue handling brief and detailed description when both are positioned after an item.
  • id 350168: Doxygen didn't parse C# type contraints properly.
  • id 351890: In some cases C# attributes were treated as properties.
  • id 353044: C99 style variadic macros were not handled properly by doxygen.
  • id 353195: Member grouping with SUBGROUPING = YES now works the same for files and namespaces as it does for classes.
  • id 354765: A command like \ingroup now ends a brief description as was the case in the pre 1.4.x series.
  • id 355922: When a function was found in a namespace but also in the global namespace, doxygen could make the wrong cross-reference.
  • id 356204: Setting HIDE_UNDOC_RELATIONS to NO could result in argument mismatches in certain cases.
  • id 357092: Spurious doxygen warning when using a class that ends with 'const' or 'volatile'.
  • id 357438: tabs and newlines were not parsed properly for html attributes inside a comment block.
  • id 357646: objcache.cpp did not compile cleanly on a system with 64 bit pointers.
  • id 361812: whitespace after the colon at the end of a Python definition caused parsing issues.
  • "struct Foo operator+()" was not parsed properly due to the "struct" keyword.
  • As a side-effect of bug 329861 Obj-C protocols and categories were no longer extracted.
  • Fixed an problem with cross-referencing Obj-C code.
  • Removed the memory leaks reported by valgrind and tuned some data structures to reduce the memory usage.
  • enums in a used namespace could cause arguments not to match.
  • fixed several cases where arguments of function/method declaration and definition did not match while they should.

Doxygen Release 1.4 and earlier


Go back to the main page.

Follow doxygen on Twitter Doxygen on freshmeat Doxygen on SourceForge