latest release v1.7.1 - last page update Tue Jun 29 2010

Doxygen Release 1.3.9.1

Bug fixes (ids refer to the bugzilla database)

Due to an error in the packaging script, an old version of doxywizard was bundled with the Mac OS X version of doxygen.
Dot would not run if doxygen was installed in a path which contained spaces (Mac OS X).
id 151012: <td> tag in HTML function documentation missed 'class="md"'
id 154689: Wrong link to members of namespaces imported from tag files when CASE_SENSE_NAMES is set to NO.
id 154700: anchors in pages imported via tag files could not be linked to.
id 154755: Files were missing from Doxygen.dsp project file. (thanks to Gerik Rhoden for sending an update).
id 154758: Fixed typedef resolution bug that could crash doxygen (thanks to Gerik Rhoden for the analysis and fix).
id 154862: Fixed problem matching array parameters that include template parameters as the array size.
id 154863: Fixed parsing problem in the preprocessor when an expression contained the division operator.

Doxygen Release 1.3.9

Changes

Changed the stylesheet so font usage is more uniform and consistent.
Changed the colors of the doxygen logo at the bottom of a HTML page. Let me know if you prefer this one or the old one.
Improved rendering of template functions and methods in the HTML output (previously these could push the method names to the right side of the page).
id 149899: A macro defined in the config file (see PREDEFINED) can now prevented from being undefined (via a #undef in the code) when its value is assigned via the := operator (e.g. PREDEFINED = A(x):=x ).
id 150631: if HIDE_SCOPE_NAMES is enabled the scope of a method in a call graph is only shown when the method is of a different class.
id 151911: Stylesheet is generated earlier in the process.
id 152164, 152166: Improved the way search results are sorted.
Changed the way function pointer arguments are represented in the detailed description.

New features

Directory information is now extracted by doxygen. Files are automatically grouped by directory. You can use the SHOW_DIRECTORIES option to enable/disable this feature. Added a new command \dir which can be used to document directories.
Language updates for Czech, Swedish, Hungarian, Danish, Russian, Italian, German, Chinese, Croatian, and Polish.
Applied a patch by Arend van Beelen which adds support for the new features introduced in PHP5.
Applied a patch by Ferdinand Wess for better handling of #import statements in Obj-C code.
Applied a patch by Adam Treat to add read and write accessors of a Q_PROPERY to the XML output.
Arnaud Bercegeay has added platform support for the Atari MiNT OS.
Included patch by James Ahlborn which improves the way nested numbered lists are layouted in the HTML output.
Included update for Hungarian translation.
Added patch to improve support for Debian (http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263542)

Bug fixes

id 123772: putting an example inside a group caused broken links to in the example list.
id 125737: Fixed link error when a @todo item was placed in the documentation of a variable inside a anonymous union/struct.
id 126344: Added initial support for member template specializations.
id 126448: Argument passed to input filter was not always quoted.
id 126745: Anchors of grouped members were wrong in some cases.
id 128585: Lists were not always rendered properly in the man page output format.
id 128809: Hidden files (starting with a dot) could not be included with for instance \verbinclude.
id 130431: Prevented recursive loop in the call graph when a function declares a local variable with the name of the function.
id 131299: \copydoc with argument A#func() didn't work.
id 131354: Fixed bug matching function declaration/implementation with using declarations.
id 135448: Improved autodetection of Qt by the configure script some more (thanks to Michael Henry).
id 135808: Removed reference to doxysearch.cpp from Doxyfile included with the source distribution.
id 138629: Included patch to make the HTML output more conformant to the XHTML standard (thanks to Jan Nijtmans).
id 144865: Variables in anonymous unions/structs did not appear as data fields.
id 148547: Added a workaround for a compile problem in pngrutils.c on AIX 5.2.
id 148671: Using "publicsomething" as a name for a base class resulted in the "public" part being stripped.
id 148707: <a href> and <br> tags are now allowed inside html headings.
id 149023: Fixed template inheritance through typedefs problem.
id 149045: Fixed several small problems related to template handling.
id 149106: Fixed problem parsing enum declarations.
id 149164: Fixed problem in the configure script when used with perl version 5.6 (thanks to a patch by Joerg Schlichenmaier)
id 149258: Example sources could be wrongly indented.
id 149263: Fixed copy/paste error in HTML_FOOTER documentation.
id 149698: Multiple lines of //!< comments were not handle correctly.
id 149711: Title of a namespace page/section was not generated.
id 149797: Forgot to turn off debug mode for the RTF output.
id 149880: Brief description of one variable could appear in the the description of the next under certain circumstances.
id 150264: linking to Obj-C protocols did not work.
id 150427: "virtual" and "const" were not nicely formatted when followed by unary scope resolution operator (e.g "const ::A")
id 150629: Enabling OPTIMIZE_OUTPUT_JAVA did not help for call graphs.
id 151457: Fixed compile problem on Solaris 4.2.
id 151452: Bug in LaTeX output for anonymous structs/unions whose members have brief descriptions.
id 151246: Parse error when using in-body comment blocks.
id 152005: Objective-C string constants appear in output with @"@"
id 152182: Spaces mess up type in Objective C functions.
id 152184: label-less parameters in Objective C functions were not parsed properly.
id 152383: Objective-C categories showed methods twice.
id 152572: \brief inside an argument description caused a bogus warning.
id 152681: Call-graphs were generated inside a table environment in the HTML output.
#include after a @file comment made the #include appear on the same line when DETAILED_AT_TOP was enabled.
User specified images & stylesheets did not work with CREATE_SUBDIR.
Nested using directives did not work for C#.
Grouped classes did not always appear in the modules section of the navigation tree.
"internal" classes appeared in the XML output.
friend classes did no longer appear in the output even when HIDE_FRIEND_COMPOUNDS was set to NO.
Fixing bug in code parser when encountering arrays and some other related problems.
Array initializers did not show up regardless of the MAX_INITIALIZER_LINES setting.
Improved support for classes with the same name but in different namespaces in combination with "using" of namespaces.

Doxygen Release 1.3.8

Changes

Rewrote doxywizard. It should be more easy to use and has much better support for running doxygen from the GUI. Feedback is welcomed!
Members of a namespace are now also added to the file in which they appear (thanks to Mike Morearty for the patch).
Included patch by Mikhail Glushenkov that fixed item 5 on the todo list (titles of html pages are now internationalized).
A macro defined in the config file can now be undefined in the source code via a #undef.
Optimized calling of dot using multiple -T flags at a couple of places (note that doxygen now requires graphviz >=1.9)

New features

New option FILTER_PATTERNS which can be used to specify multiple input filters, and let doxygen select the right one based on matching the source file name with a specified pattern (thanks to a patch by James Ahlborn).
id 142939: New commands \protocol and \category which can be used to document Objective-C protocols and categories in the same way the \class command does for classes.
Included patch that removes some cosmetic annoyances in the man page output (thanks to Chris Croughton).
Added internationalization support for Afrikaans and Lithanian. Included language updates for Dutch, Czech, Italian, Brazilian, Croatian, Japanese, Norwegian and Russian.

Bug fixes

id 120810: \code fragment has links first time, but then no more.
id 124214: Fixed parse problems with single quoted strings in PHP.
id 135508: Using a namespace in C# did not get interpreted correctly.
id 137842: Using @todo/@bug/... and disabling the generation of the list, still caused a colon to appear in the output.
id 138075: A comment block containing a \code block with C style comments was not properly parsed.
id 138307: Fixed parse problems with single quoted strings in PHP.
id 138394: C style comments placed on the same line after a macro definition appeared as part of the macro's value.
id 138429: Fixed language setting for HTML output when using traditional chinese.
id 140259: Using @dotfile in a comment block could cause broken @refs to sections defined after the @dotfile command.
id 141915: Fixed a couple of problems with the RTF output.
id 141918: Fixed a couple of problems with the RTF output.
id 142118: Fixed compile issue with the mingw compiler.
id 142288: Doxywizard crashed when started (fix was applied to version 1.3.7 as well).
id 142741: Links in todo/bug/... lists were broken if CREATE_SUBDIRS was enabled. Same was true for the built-in diagrams.
id 142925: Autolinking to a member of a class from a page inside a namespace did not work.
id 142940: Due to a misplaced break statement a examples included with \example was shown twice in the output.
id 143107: Made some cosmetic changes to the HTML and HTML output, (thanks to David Baird for the patch).
id 143340: Fixed autolink problem for names ending with a colon or a <br> tag.
id 143412: Fixed problem parsing Objective C class methods.
id 143413: Fixed problem parsing Objective C root classes.
id 143593: Under certain conditions the XML output could contain a reference to a non-existing class.
id 145295: Variable of a templated type was mistaken for a function.
id 145583: Fixed problems handing formulas and graphs defined using @dot in combination with CREATE_SUBDIRS = YES.
id 147253: Quotes in a class initializer could confuse the source code parser.
id 147425: The class diagram did not show the relation to the template specialization when inheritance was done via one or more typedefs.
Fixed case where template classes "used" via typedefs were not properly shown in the collaboration diagram.
Variables explicitly declared external were reported being defined at the place they were actually declared external.
Fixed bug in the XML schema for enum values with initializers.
Documentation of a member group did not appear in the XML output (thanks to Chris Croughton for the patch).
Command line build process failed under windows if the name of the directory in which sources are located contained spaces (thanks to Mikhail Glushenkov for the patch).
Improved cross-referencing to methods of a template instance variables (thanks to a patch by Jeff Apple).
Included a patch by Enrico Schnepel that puts the same output files in the same subdirectories (with SUBDIRS = YES) for subsequent runs (on slightly modified input files) and also renumbers the dot nodes so they are only regenerated when actually changed.
Unsupported HTML end tags and unsupported begin tags with attributes are now copied to the output as is.

Doxygen Release 1.3.7

Changes

The \param command now has an optional input and/or output attribute. The syntax for an input & output parameter is for example: \param[in,out] name Description.

New features

Added new option CREATE_SUBDIRS which when enabled makes doxygen distribute the generated output evenly over 100 subdirectories.
Added support for Qt's properties (i.e. Q_PROPERTY) which can be documented by putting a documentation block in front of the macro or by using a comment block with the new \property command.
Added new commands \manonly and \endmanonly to enter man page specific text and commands in the generated man pages (thanks to Carsten Stiborg).
Included new python based translation report script, which now replaces the old perl based version (thanks to Petr Prikryl).
Improved parser to also support parsing of Objective-C implementation files.
Added new config option EXTRACT_LOCAL_METHODS which can be used for Objective-C code to extract methods definition in the implementation section that are not present in the interface.
Added new config option STRIP_FROM_INC_PATH which allows to specify a list of paths that, if matched, will be striped from the #include statement in the generated documentation of a class.
Added new command \includelineno with works as \include except it will add line numbers to the code (thanks to Giancarlo Niccolai for the patch).
Added BeOS support, thanks to a patch by Mark Hellegers.
Included update for the French translation, thanks to Jacques Bouchard.

Bug fixes

id 133388: Fixed problem parsing '"' inside multi-line C++ style comment blocks
id 134265: Doxygen now outputs unrecognized HTML tags instead of removing them (thanks to �ric Malenfant for the patch).
id 134869: When HIDE_SCOPE_NAMES was set to NO, the methods of an Objective-C class did not have the right name.
id 134876: Fixed problem with forward declaration of a protocol in Objective-C.
id 134647: using a parameter name ending with "const" was not accepted by doxygen.
id 134639: Fixed parse problem in the preprocessor.
id 137398: add \% command to the documentation.
id 137730: Fixed problem for man pages with non numeric extension (thanks to a patch by Joe Schirmer).
id 138652: Line numbers for defines with /* */ comments were wrong (thanks to J. Noack for the patch).
id 139591: Fixed problem parsing nested template arguments with comments.
id 140012: a variable could appear in a group twice if it was declared externally somewhere.
id 140540: Fixed problem parsing "@" in the source code parser.
id 141133: Spaces were stripped in default arguments such as f(const char *t=" \t")
id 141364: Members of an anonymous nested structure had no brief comment and no link to the detailed description if available.
Fixed recursive lockup problem that was caused by two or more namespaces using each other (i.e. a cycle in the usage relation).
Included patch by Erik Zeek to allow the explicit setting of QTDIR to override the "search for Qt" algorithm in the configure script.
Parsing of tag files produced for Objective-C code now works.
Objective-C: Improved hyperlinking of source code, handling of prototypes and the list of all members of a class now also contains the members of class categories.
Third argument of @class was ignored (thanks to Mahadevan for the patch).
Fixed problem with collaboration diagrams for template instances whose template parameter list contained qualified scope names (e.g A<B::C>).
Removed bogus warning about undefined documented function for classes that were made friends of other classes.
Spaces where not preserved for @code block inside a @example block.
Undocumented dependency relations where not shown in some cases even though HIDE_UNDOC_RELATIONS was set to NO.
Fixed two bugs that resulted in invalid HTML output.
For Unix the default FILE_PATTERNS did not include upper case versions such as .C and .H
Fixed incorrect character encoding problem for the generated tag files.
Fixed problem that could lead to memory corruption/crashes.
Included a patch by Bernhard Rosenk to fix a compile problem with doxywizard using a recent Qt version.
Call-graphs were missing if a file name ended with ".C" and K&R function definitions were used.
Improved source code generation performance when there are many typedefs with the same name in different scopes.
Linking to a section resulted in the wrong label in the XML output.

Doxygen Release 1.3.6

Changes

For projects with many nested classes, namespaces, typedefs and using statements, doxygen could become very slow. This should now be improved significantly.
Made some cosmetic changes to the HTML output (thanks to Ben Harper).
STRIP_FROM_PATH now by default strips the path from which doxygen is run (i.e. $(PWD)/ on Unix)

New features

Make a start with adding support for Objective-C. Doxygen can now parse Objective-C header files (including protocols and categories). Thanks to Apple for donating hardware.
Include a patch by Hauke Duden which adds preliminary support for the D programming language (see http://www.digitalmars.com/d).
C Comments inside #defines are now preserved. This could be useful to document boilerplate code.
Included patch to replace tabs by the proper amount of spaced inside code fragments in the XML output (thanks to Alexandr for the patch).
Included Gerik Rhoden's fixes for the .dsp/.dsw files found in the wintools dir.
Examples (documented via \example) are now included in the XML output.
New option SORT_BRIEF_DOCS which when enabled will list the declaration section of the documentation (with the brief descriptions) in alpabetical order, instead of declaration order (thanks to Akos Kiss for the patch).
Included patch for Hungarian translation (thanks to Akos Kiss) and for the Serbian language. Added support for mixed Korean/english (thanks to Jihoon Chung). The translator report script was also updated (thanks to Petr Prikryl)

Bug fixes

id 120070: Included workaround for build problems with RedHat 9 (thanks to Tim van Holder)
id 128054: Fixed rare case where doxygen crashed due to a recursive lock-up.
id 131404: Fixed problem cross-referencing PHP member functions.
id 131434: Clarified confusing warning message.
id 131446: Extra attributes of a <a href> tag (like target) are now copied to the HTML output.
id 132535: Fixed problem with generating man page output for groups with brief descriptions.
id 132772: Fixed compile problems on HP-UX using acc compiler (thanks to Clyde Gerber).
id 133300: Fixed missing cross-reference to "c" in constructs such as "a[b].c"
id 133482: Fixed spurious cross-references to member function which was shadowed by a parameter name.
id 133986: Attributes of the <img> tag where not written to the HTML output.
id 134123: Fixed problem with multiple arrows between nodes in the graphical class hierarchy.
\ref in dot graphs was not working correctly (thanks to Eoin MacDonell for the fix).
Grouped pages in the XML output did have the same id as their group.
Fixed problem handling environment variables inside a quoted string in the config file (e.g. "$(HOME)/My Path/").
Using "\mainpage notitle" caused the "notitle" to appear in the treeview.
Page references where wrong in the latex output when PDF_HYPERLINKS was disabled.
Words inside a hyperlink could be hyperlinked, resulting in invalid HTML.
Fixed parse error handling function pointer arguments in K&R-style code.
Doxygen could crash when it failed to enter a directory.

Doxygen Release 1.3.5

Changes

Doxygen now only regenerates a dot image if it has actually changed! This could significantly reduce the time of any run after the first. Checking if a graph has changed is done by computing an md5 hash for the graph description which is then stored along with the image generated by dot and compared in subsequent runs.
Improved the way lists look in the man pages (thanks to Silke Reimer).

New features

Added support for parsing K&R style function prototypes. Please try it on your favourite legacy C project and report any problems.
Included languages updates for Traditional Chinese, Danish, German, Korian translation.
id 120464: doxygen's XML output does now assign a prot="..." attribute for nested classes (thanks to Paul Ross for the patch).
Added new configuration switch XML_PROGRAMLISTING to enable/disable generating source code listings as part of the XML output (thanks to Paul Ross for the patch).
Added new config option ABBREVIATE_BRIEF which makes the abbration process of brief descriptions configurable and language independent (thanks to Jake Colman for the patch).
The alphabetical class list now comes with a quick index (thanks to Marcin Zukowski for the patch).
An XSLT script "combine.xslt" is now generated in the XML output directory. It can be used to combine XML files into one big file.
The source code is now indexed and thus searchable when the source browser and search engine options are enabled.
Added "dist" target to the makefile (thanks to Erik Zeek)

Bug fixes

id 119778, 123385: Documentation in the body of a function could not be combined with a detailed description before the declaration.
id 122852: References to grouped functions were wrong in certain cases.
id 123031: problem matching f(const char) with f(const char cc).
id 123140: typedef'ed enums whose tag name was the same as the typedef name did not appear in a group.
id 123145: Under certain circumstances an assertion failed message was produced.
id 123206: Fixed problem in qtools when opening files in text mode.
id 123322: The search page did not honor DISABLE_INDEX.
id 123420: Functions with a brief description caused bugus </em> tags in the HTML output.
id 124114: typo in the generated PHP search script could cause errors in the search result page.
id 124187: Setting EXTRACT_LOCAL_CLASSES to NO, could result in a broken "More..." link in documented local classes inside a namespace.
id 124214: Fixed problem in search indexer, which could crash doxygen (thanks to Daniel Koebbing for the patch).
id 124545: fixed a number of problems in the generated search script.
id 124815: Fixed compile problem in filedef.h for aCC on HP-UX.
id 125369: Fixed inconsistency of showing files in the tree view (thanks to a patch by Alexey Neyman).
id 125424: Font size was not reset after @endcode or verbatim block in the latex output.
id 125654: Character encoding was not correct for html help treeview (thanks to Sawada Kentaro for the fix).
id 125367: Fixed problem with producing links in case files with the same name (but in different directories).
id 126968: Fixed problem parsing verbatim string literals such as @"\" in C#.
id 127094: Fixed character encoding problem in the XML output.
id 131364: Fixed parse problem when initializing a function pointer.
Links to classes, files, namespaces and groups in the search results were broken (missing file extension).
Doxygen logo is now transparent even when viewed with IE.
Using a character with ascii code 0x06 in a comment block could crash doxygen if the preprocessor was enabled.
Fixed problem handling conditional commands and grouping (thanks to Silke Reimer for the patch).
Fixed problem using \dotfile in combination with RTF output (thanks to Vegard Larsen).
Fixed several problems related to the new md5 hash feature.
Undocumented functions referenced in a comment block were linked to anyway.
Fixed a number of typos in the config file documentation (thanks to Boaz Kelmer)
Workaround for toupper() bug for Russian (thanks to cav@cryptopro.ru)
Fixed problem that HTML image maps ended up in the RTF output.
Fixed bug in code fragment parser that could cause memory corruption in certain cases.
Fixed problem matching definition and declation of functions, which could cause bogus warnings for functions with the same name but in different namespaces.
Using "/// @file" to document a file quickly was not possible, while "/** @file */" did work. Now both work.

Doxygen Release 1.3.4

Changes

Rewrote the search engine. The doxysearch CGI binary has been replaced by a PHP script which is generated by doxygen. Also the index file is now generated by doxygen and requires way less memory. This should make it much easier to use the search facility. All that is required is a web server with PHP 4.1 or higher. Please report any problems you find.
Changed the way class names are resolved. This can result in a significant speedup for projects that use namespaces and typedefs (including Java projects). Thanks to Edmund Green for the performance analysis and ideas.

New features

Added support for the ø, and Ø character entities.
Added language updates for Korean, Swedish, German, Russian, Croatian, Brazilian, Spanish, Japanese, French and Italian.
Added new \relatesalso command, which can be used to put a file member also in the documentation of a class (thanks to Ian Scott for the patch).
Added support for pseudo IDL files with the .pidl extension (as used in TAO). Thanks to �ric Malenfant for the patch.
Added new commands \dot ... \enddot to include a dot graph in a comment block (thanks to a patch by Eoin MacDonell). Inside the URL attribute of a node you can use \ref to make links to documented items. See the documentation of the \dot command for an example.

Bug fixes

Fixed recursive lock-up problem handling "using" of namespaces.
Doxygen incorrectly translated \\htmlonly and \\latexonly to \verbatim in the output.
Using the -d Time option caused: message.cpp<100>: Internal error: Requested unknown option QUIET at the end of the run.
Static members appeared in the todo list even if EXTRACT_STATIC was set to NO.
Fixed problem matching f(const int *i) with f(const int * const i),
Fixed case where a variable could get by assigned a bogus "()" in the heading of the detailed description.
Fixed problem handling extern"C" (without the space).
\ref file.c ended up as file::c in the output.
Special characters in generated texts were not always translated into proper LaTeX commands in the LaTeX output.
Fixed problem parsing "const ::Class *func()" and "static ::Class *func()". The keywords were seen as namespaces. due to the use of more than one const keyword.
Fixed two bugs in compound.xsd schema, thanks to Ademar Aguiar.
Fixed some more problems linking typedefs in combination with namespaces.
id 120637: Fixed parse problem handing character literals such as '"' inside the initializer list of a constructor.
Fixed file handle leak when INLINE_SOURCES was set to YES.
Fixed problem handling Java packages (Internal inconsistency warnings).
Fixed problem preprocessing @verbatim blocks containing C comments.
Fixed problem handling preprocessor statement just before a function body when ENABLE_PREPROCESSING was set to NO.
id 122457: INLINE_SOURCES feature was broken (only showed the first line)

Doxygen Release 1.3.3

New features

Included update for VC++ 6.0 project/workspace files (can be found in wintools). Thanks to Simon Goodwin & Johan Eriksson.
Added new debug flag "-d Time" which will report the elapsed time for each message printed, and will also show the total running time along with the time spend on external tools such as dot. Note: If you have a project that takes doxygen a long time to process, please send me the output so I get a global idea where to optimize.
New option SUBGROUPING which can be set to NO to have \nosubgrouping for all classes (thanks to Torben Koch for the patch).
Added XML schemas for validating the XML output, and to help writing XSLT files. The generated index.xml now has a complete schema, the compounds not yet. Thanks go to Alexej Humbach for doing a lot of the work. Note that a couple of "id" attributes in the XML output have been changed to "refid", and section tags are now nested.
Included language updates for Traditional Chinese and Japanese.

Bug fixes

Doxygen crashed when parsing a comment block with only a \mainpage command.
Fixed problem matching namespace members.
Fixed scanner push back error for ALIASES with long definitions.
Default main page was wrong if DISABLE_INDEX was set to YES.
Argument of type array were not properly parsed in Java, causing problems when documenting them with @param.
\image with "" as caption didn't work.
If the last \section in a comment block was empty, doxygen produced warnings.
Call graphs were only generated if REFERENCES_RELATION was set to YES.
Link could be wrong if a member's name was found in multiple namespaces.
A function returning "struct s *" caused a bogus recursion relation in the call graph.
Improved handling backslashes for the perlmodgen (thanks to Miguel Lobo).
Page anchors did not appear in the tag files.
\ref's to grouped pages were not generated correctly.
Fixed parse bug when putting \image inside a HTML table.
Made the documentation parser more tollerant to spaces inside HTML commands.
Doxygen now issues a warning if invalid commands are used inside a single-line C++ comment (such a @see and @image).
Fixed parse problem for the semicolon in the following: Class A : a(";") {};
Doxygen now resolves links to classes imported in a namespace via using declarations or directives.
Doxygen now issues a warning when @code, @verbatim, @htmlonly, or @latexonly are not properly terminated.
Fixed "Internal inconsistency" messages when parsing Java packages.
A member did not appear in its group if it was first declared without documentation and then defined with documentation (with \ingroup).
The <caption> tag was put at the end of a <table> in the HTML output, while it should be the first tag after <table>. This is now corrected.
In the LaTeX output, the page references were missing for the links in the documentation when PDF_HYPERLINK was set to NO.

Doxygen Release 1.3.2

Changes

The main page (\mainpage) can now be completely customized, by using no project name or using "notitle" as argument for \mainpage.
Changed the look of the quick index on top of each page using CSS.

New features

Added new command \callgraph which can be put in the documentation of a function to get a callgraph. In the config file a new option CALL_GRAPH is added which can be set to YES to enable callgraphs for all functions (note that this will slow doxygen down!).
Added new boolean config option UML_LOOK which can be enabled to give class and collaboration diagrams a more UML conformant look (thanks to Dominick Paniscotti).
Added new commands \xmlonly and \endxmlonly which can be paired to form blocks of text that only appear in the XML output.
Added sub-indices for the lists of all class/file/namespace members to filter out just of type of members.
Included language update for Czech, Italian, Portuguese, and French.

Bug fixes

Doxygen could crash if a namespace and a class with the same name were found in the global scope.
Fixed problem handling multiple \xrefitem's in one comment block (could crash doxygen).
Added check for recursive group relations to prevent lock-up/crash while generating the group index.
Doxygen could crash if a group contained only undocumented members.
Putting a #include inside a function body would cause the line numbering to be off.
Fixed cause of a failed assertion when @retval or @param was the last text in a comment block.
Improved scope detection for code parser when dealing with examples (imported via \example).
Fixed preprocessor bug handling "#if!defined(VALUE)" (note the lack of a space).
Added warning if @subsection, @subsubsection or @paragraph were found in the page context.
French translation was broken (probably due to a dos2unix accident).
Underscores inside a <pre> section did not appear correctly in the LaTeX output.
Fixed several typos in the generated config file (thanks to a patch by Justin Zaglio)
Formula's inside comments directly in front or behind function arguments did not work.
Fixed code parser problem when //<! was nested in a normal C comment.
Included a number of fixes for typos found and corrected by Justin Zaglio.
For #define values that were constant strings, doxygen tried to link the text inside the string when shown in the documentation.
The source-browse parser did not link to class variables used in inline function if the variables were defined before the functions.
The first paragraph after a <h1> or similar heading was not put in a paragraph context in the generated output.

Doxygen Release 1.3.1

Changes

A multi-line C++ comment block now has to be aligned in order to make doxygen treat it is one block. As a result the following is treated as one comment block:
```
           int var; //!< variable.
	            //!  more info about var.
           int anotherVar;
       
```
while this results in two comment blocks:
```
           int var; //!< variable.
                //! info about second variable
           int anotherVar;
       
```
Hopefully this will give more intuitive results. Tabs are replaced by spaces according to the value of TAB_SIZE in the config file.
Modified the CSS to change the look of the HTML output, and made the stylesheet a little more powerful (thanks to a patch by Ben Harper).
Formula alignment in the HTML output is now controlled via CSS (thanks to a patch by Vassilii Khachaturov).
The option TEMPLATE_RELATIONS now defaults to NO.

New features

Added new command \xrefitem which enables user-defined commands that act like \todo and \bug, i.e. produces a related page containing all items, which is cross-referenced with the documentation blocks where the items are placed.
Added support for package scope in Java.
Added alt attributes to user included images in the HTML output (thanks to patch by Vassilii Khachaturov)
Added XML_OUTPUT option to allow a user defined location for generating XML output (thanks to a patch by Emmanuel Guerin).
Included language updates for French, German, Czech, Italian, and Brazilian.

Bug fixes

Occurrences of <span> and <div> tags in the documentation were not properly handled.
Fixed problem parsing the following pattern "namespace { .... } typedef ....", which could crash doxygen if IGNORE_PREFIX was used.
The project name is now put in front of each title of a HTML page for easier bookmarking.
In C# enums, classes and structs without (optional) ; were not properly parsed.
Though still not perfect, I Improved the way namespace aliasing is handled. It should now work inside other namespaces and for computing class and usage relations.
Fixed problem documenting typedefs of function pointers using \typedef.
Links to groups imported via tag files were broken.
Fixed problem resolving class relations for nested classes within namespaces.
Static members can now be documentated in a separate file using \fn as long as they have unique names. If the names are not unique the documentation must be located in the same file (as was required before).
In arguments and return types of the form NA::A were not linked if NA was a namespace alias to a documentation namespace and A a documented class name.
Matching a declaration f(NA::C c) with f(C c) did not work if NA was a namespace alias.
Undocumented classes had wrong links in the treeview frame.
Pages whose title contained < or >'s were not written correctly to the tag file.
Fixed preprocessor bug: "a##b" was not correctly expanded if argument "a" or "b" was empty.
Putting \todo and friends inside the documentation of enum values did not result in an entry on the todo list page.
Fixed some problems compiling with versions of flex >2.5.4, but also added a #error if these are used, since they produce incompatible parsers (a bug report has been filed, but no feedback was received).
Characters >=128 are now written as &#nnn; to the XML output. (thanks to a patch by Michiel Ouwehand).
The table row backgroup color of the "all member" list was hard-coded in the HTML output. This is now controlled by the stylesheet.
Fixed problem handling omission of the optional arguments of the \image command.
Enabling HIDE_IN_BODY_DOCS did not work properly if C++-style special comments were used inside the body of a fucntion.
Fixed problem cross-referencing variables used as a guard (i.e. if (var) ...)
Setting ENUM_VALUES_PER_LINE to 0 caused a division by 0 error.
Autolinking did not work for members that were grouped and imported via tag files.
The divide symbol "/" did not appear in the output for array/define initializers
Fixed paring problem parsing "operator <b>new</b>" in the documentation.
Fixed problem with resolving template relations (as reported by Kris Thielemans).
Members in the todo list were not shown correctly (with dot separators) if OPTIMIZE_OUTPUT_JAVA was set to YES.
Fixed problem handing "class A { public: A::f(); };" which is accepted as valid C++ by a number of compilers.
Putting a /* inside a C-comment without matching */ caused the preprocessor to ignore the rest of the file.
Improved the way typedefs are resolved.
Fixed parse problem for the following PHP code: $color='#FFFFFF'
Using @dontinclude could cause broken LaTeX output.
Links to examples (using \example) were broken.
Class members appeared twice in the index of the latex output.
Fixed problem putting \if..\else..\endif around a pair of \defgroup's

Doxygen Release 1.3

Changes

Increased internal buffer size from 16K to 256K for a number of scanners, so the "input buffer overflow, can't enlarge buffer because scanner uses REJECT" error should occur less easily.
Style commands like \e, \a or \c will now be terminated when one of the characters in the following string is found: ".,()[]:;?", example: "a point (consisting of @a x and @a y)"
Setting OPTIMIZE_OUTPUT_JAVA to YES, will automatically set INLINE_INFO to NO.
Quotes strings (like "\0" or "%H.%d.%Y") are now considered to be words (hence the \ and % do not have to be escaped).

New features

Added new configuration option USE_WINDOWS_ENCODING which can be used to select windows specific character encodings for some languages. (thanks to Piotr Kaminski).
Added new configuration option LATEX_HIDE_INDICES which can be used to suppress the various indices that are normally generated in the LaTeX output (thanks to Ken Yarnall for the patch).
Added new option MAX_DOT_GRAPH_DEPTH to set the maximum distance from a root node after which the class or include graph will be truncated. Setting this to a low value should considerably reduce the time doxygen needs on large projects.
Included updates for French, Korean, Polish, Croatian, and Danish translations.
Access to title of user defined user defined sections is now possible from the doxmlparser.
<div> and <span> commands can now by used in the documentation. Their effect is limited to the HTML output though (thanks to Frank Schimmel for the patch)
Added inline, virtual, explicit and mutable attributes to XML output (thanks to patch by Michiel Ouwehand).

Bug fixes

Fixed out-of-memory bug for files containing using directives and including themselves (indirectly).
Doxygen could crash if two \todo-like commands appeared on the same line.
Non-inline cast operator was not properly parsed.
Fixed preprocessor problem with parsing /*//*/
URL's in the docs using <a href=""> caused a nested link.
"using namespace A::B;" confused the code parser.
Interface keyword was not recognised in C# (thanks to Onorio Catenacci for the patch).
Line counting was incorrect when parsing multi-line formulas.
\section's in a \mainpage are now correctly numbered in the LaTeX output (nesting level was one too deep).
\ref to lower case names did not work (thanks to Herman ten Brug for the patch)
escaped quotes (") were not preserved in the config file when it was updated (thanks to Herman ten Brug for the patch).
PHP related fixes contributed by Vaclav Dvorak:
- #-style comment handling,
- adds (problematic) support for define() constants,
- adds ".phtml" as a supported file extension for PHP code (not very common, but still...),
- fixes handling of code like "include 'file.inc';" (was parsed as a variable definition),
- removes the variable insidePHPCode (was not needed),
- fixes spaces in function argument lists (the '$' was the problem).
Functions documented with \fn did not get transferred to declaration or definition (depending on where the comment block was put).
If a function definition was documented and grouped the declaration was not even if the same documentation block was used for it.
Fixed bug in code parser that could crash doxygen under certain conditions.
Fixed some spacing problems in the LaTeX output (thanks to patches by Roberto Bagnara).
Mail address containing the '+' character were not properly parsed (thanks to Jon Parise for the patch).
Fixed duplicate/wrong id's of grouped members in the XML output.
Docparser reported wrong error if unknown command was found inside \c (or similar command).
Preprocessor got confused when parsing a special comment as part of a #define and containing a ' or ".
subgroups defined with @defgroup could be reordered if @addtogroup was used.
Projects name was not shown as the root of the treeview anymore.
Links to pages imported via tag files were broken in the treeview frame.
removed leading and trailing whitespace within a \code ... \endcode block.
Constant class variables with constructor were parsed as functions.
Autolinks of the form class#member were not shown as class::member or class.member in the documentation.
Fixed problem parsing things like echo('!$tar' . '"'); (PHP).
Fixed problem distinguishing f(__true_type) and f(__false_type)
Fixed lack of translation of some latin2 characters in the latex output (thanks to Aleksander Kupiec for the patch).
Group members appeared in the treeview or html help index regardless if they were documented.
The treeview page was not rendered with the right character set (it was always English).
Explicit template instantations appeared as a variable in the output.
Java instance and static initializer blocks are now correctly parsed and can be documented.
Fixed bug in the LATEX_HIDE_INDICES option.
Fixed bug parsing simple lists (last word or token could get repeated).
\section titles did not appear in the RTF output.
Tables were not correctly rendered in the RTF output.
Verbatim fragments were not properly rendered in the RTF output.
Fixed some cases where collaboration relations were not visible due to typedefs.
Fixed some compiler warnings that occurred with more recent versions of gcc.
Auto-links to files were shown with as file::c instead of file.c.
@ref namespace::class was not parsed correctly.
Undocumented enums could appear in the declaration part of the output even though HIDE_UNDOC_MEMBERS was set to YES.
\anchor tags now appear in the tagfiles as <docanchor> again.
Hyperlinks in the LaTeX were broken in some cases.
Fixed case where a global variable was not linked from within a function body.
Include dependencies graph was shown at the place where the "included by" graph should have appeared.
A // comment following by a //! comment was not handled properly by the source browser.
If the definition of nested class was found before the definition of the outer class, its name was displayed without scope.
If a parameter of a prototype was documented (with a separate documentation block) and the name of the parameter in the definition was different, the wrong name could be shown in the documentation.
Fixed bug handling \line, \skipline, and \until

Doxygen Release 1.3-rc3

Changes

Rewrote the implementation of the tree view feature (see GENERATE_TREEVIEW). The new implementation should be much faster, but does require a browser that supports JavaScript, DHTML, and CSS. Please report any problems you find.
Changed the way dot is launched under Linux/Unix (vfork i.s.o. fork) so less memory is required (thanks to a patch by Thorsten Behrens).
Changed "Methods" to "Member Functions" in the output (thanks to patch by Tom Emerson).
STRIP_FROM_PATH now ignores the exact casing of characters, which makes things simpler on Windows.
Style modifiers such as <b>, <em> and <pre> are now capable of spanning multiple paragraphs.
Made some improvements to the documentation, including a diagram showing the information flow between the doxygen and various other tools (see the getting started section).

New features

Added support for comment blocks generated by Rational Rose's ANSI C++ code generator (thanks to a patch by Martin Beaudoin).
Included language update for the Serbian and Japanese.
Included patch by Ryunosuke Satoh to reduce size of the executable when building for Cygwin.
Tables in the docs were ended with a bogus row in the LaTeX output.
A \link to a member variable that is grouped using \defgroup can now be done from another member without specifying the full scope.

Bug fixes

@addindex now works on the whole line instead of a single word (as was already suggested in the docs).
source code line in the XML output didn't escape special characters like & anymore.
Fixed small bug in german translation (thanks to Jens Seidel).
e-mail addresses with multiple dots got truncated when linked.
Attributes of html commands with value "" where not properly parsed causing the image in the legend page not to appear.
Fixed excessive memory usage in the "Building member list" phase while using todo/test/bug items (thanks to Gerik Rhoden).
Fixed parsing problem in PHP. Doxygen was expecting classes to end with a semicolon (thanks to Jaime Uriel Torres for the patch).
Using <dt> with also adding a <dd> caused a parse error while it is legal HTML.
The identifier "package" in C/C++ code was wrongly interpreted as a Java keyword.
\todo item at the end of a comment block caused "unexpected character" error while generating the XML output.
\ref did not work when the argument was a file name.
\ref and \link are now allowed inside a <td>..</td> section.
Argument matching routine was not able to distinguish between f(long n) and f(long long n).
Classes were listed in the alphabetical index with full scope.
\copydoc did not work recursively for members.
Fixed a number of small memory leaks (I used ccmalloc to detect them).
The HTML command <SUP> was not parsed correctly if it was prefixed with an identifier (i.e. blah<SUP>).
HTML tags were not properly parsed if there was a linebreak after the tag name.
The \~id command was not working properly. The section was always generated regardless of the OUTPUT_LANGUAGE setting.
id attribute was missing from the sect tag in the XML output.
Links to files or file members could be wrong if SHORT_NAMES was set to YES and the file was imported via a tag file.
Attribute lists inside an enum in an IDL file were not properly parsed.
Fixed problem in code browser that prevented linking to global variables defined in other files.
When putting a "using namespace X" in a header file doxygen did not recognise this in files that included the header file.
Fixed bug in parsing sections without title.
doxytag did not include anchor in the search index. Thanks to Joerg Schlichenmaier for the fix.
Using an auto-list as an argument of @todo and friends did not work.
A class with all members in a section grouped could result in broken LaTeX output (empty CompactItemize list).

Doxygen Release 1.3-rc2

New features

Added support for importing members via using declarations.
Anchors and sections (and references to them) are now supported in all comment blocks, not just \page blocks.
Dot files imported via @dotfile now produce images maps in the HTML output. Use the URL node attribute in the dot file to make a link (thanks to Marco Dalla Gasperina for the patch).
New config option WARN_IF_DOC_ERROR which allows documentation problems to be shown, while other warnings (such as warnings about undocumented members) can be hidden (thanks to Miguel for the patch).
Included language update for German and Italian.
Added support for &tm; (trademark) and ® (registered).
Added "static" attribute to methods in the XML output to ease parsing.

Bug fixes

A <pre> .. </pre> section with included blank lines causes warning about missing </pre> marker.
"typedef enum { a };" confused doxygen's parser, while most compilers seem to accept it without warnings.
\deprecated item alone in a comment block caused a crash.
Putting @todo (and similar commands) inside a function body did not result in correct cross-references with the todo list.
Java interfaces were not detected as such.
Fixed some localization problems in the XML output.
Fixed problem handling multiple \par commands (headings were wrong).
Fixed array out of bounds assert that was triggered while parsing.
Links to pages were not properly resolved in hyperlinked PDF.
Using a \name command without //@{ .. //@} scoping could cause a segmentation fault.
Including images with @dotfile caused problems in the LaTeX output.
Local variables and parameters now properly hide globals with the same name in the source browser, reducing wrong references.
Verbatim blocks in the documentation could break the RTF output.
RCS/CVS tags did not appear in the output.
@note section result in section with type "bug" in the XML output.
Dot graphs were truncated too quickly in some cases.
Files with a .php4 extension are now recognised as PHP files.
Source browser could get out of sync causing wrong cross references.
Text after @} could end up in another documentation block.
Putting a style command such as \c or \b at the end of a line, before a auto list item, caused the list item to be ignored.
Autolinks to files did not work anymore.
@copydoc of a target without documentation could cause a crash.

Doxygen Release 1.3-rc1

Changes

New validating parser for documentation blocks that replaces the old parser (which was actually only a lexical scanner).

The new documentation parser will now pass attributes of html tags to the html output. Example:

       /*! \mainpage A Dutch Table
        * <table bgcolor="black" border="0" cellspacing="2" 
	*        cellpadding="2" align="center">
	* <tr><td bgcolor="red">red
	* <tr><td bgcolor="white">white
	* <tr><td bgcolor="blue">blue
	* </table>
	*/

Doxywizard will now run doxygen from the directory where the config file is found, so paths can be made relative in the config file. This will now also work if the config file's path or name contains spaces.
Doxygen style comment blocks found in the body of functions are now appended to the function's documentation block.

New features

Added rudimentary support for C#. Parsing should work, but not all attributes are handled correctly.
Included perl module generator by Miguel Lobo. Setting GENERATE_PERLMOD to YES in the config file will produce a perl module in the output dir.
Included language updates for French, Czech, and Russian.
Included a number of enhancements to the xml parser (thanks to a patch by Tree).
Locally documentated parameters now appear in the XML output (thanks to Cormac Twomey for the patch).
The preprocessor now inserts line control commands where appropriate.

Bug fixes

Aliased \if .. \endif commands around a \brief section were not handled properly.
Warnings for undocumentation members were not generated anymore in certain cases.
A member of a group linked with \ref showed the group's title as link text instead of the member's name.
Using aliased commands whose definition contained \n's caused the code browser to put definition links at the wrong line numbers.
Todo items inside related pages appeared in tag files, causing warnings about duplicated labels.
Included a patch by Ryunosuke Satoh that fixes some issues when compiling in a cygwin environment.
The presence of using declarations could result bogus entries in the class hierarchy.
Links in the hyperlinked sources could point to the wrong global function depending on the order in which files were parsed.
Using \retval in combination with parameters that are documented on the spot, caused bogus warnings about undocumented parameters.
id attributes of references/referencedby relations are wrong in the XML output.
Links could wrongly point to a class in an outer scope instead of a typedef with the same name in the inner scope.
A reference in the code to a member of a derived class that is defined in a base class is now resolved properly even if both classes are imported via tag files.
Language codes were wrong in the html help output for some languages (thanks to Erwin Hoffmann for the patch).
Fixed case where function was detected as a variable.
if HIDE_UNDOC_CLASSES is set YES, doxygen will not complain about undocumented classes.
Included RTF output fixes by Gorden Machel.
Global variables of complex types were not properly cross-referenced.
Fixed argument matching bug for nested template classes; matching "f(A::B<T>::C c)" with "f(C c)" within context A::B<T>
Fixed preprocessor bug handling nested comment blocks (the */ of the inner block was eaten).

Doxygen Release 1.2 and earlier

Go back to the main page.


	Home Manual Mailing Lists Mail archive FAQ ChangeLog Todo / Wish List Report bugs Doxygen users Articles Other Doc Tools


	SVN SVN tarballs Download Download manual Helper tools RPM Packages Debian Packages



	Help doxygen! Contributors