Doxygen 1.8.10 发布，文档生成工具

Doxygen 1.8.10 发布，更新内容如下：

• change the build system to use cmake [ view ], [ view ], [ view ], [ view ], [ view ], [ view ], [ view ], [ view ]

• Add support for basic XML syntax highlighting. [ view ]

• Added documentation for ``` style fenced code block and more robust parsing [ view ]

• Added function arguments to the LaTeX toc [ view ]

• Added missing files and build instructions [ view ]

• Added missing libraries for building doxysearch on Windows [ view ]

• Added support for language codes [ view ]

• Added type constraint relations for Java generics to dot graphs and XML output [ view ]

• Adding commands /hidecallgraph and /hidecallergraph [ view ]

• Adjust test script for longer version number [ view ]

• Adjusted version in configure script [ view ]

• Alignment of project name [ view ]

• Allow selection of specific translators to compile in at build time [ view ]

• Based on the report of Peter D. Barnes in the doxygen forum (http://doxygen.10944.n7.nabble.com/doxygen-1-8-9-1-upgrade-errors-td6990.html) [ view ]

• Better error message in case of IDL inconsistency [ view ]

• Bug 659590 - EXTRA_PACKAGES can't handle package options [ view ], [ view ]

• Bug 739680 - Using HTML entities in PROJECT_NAME [ view ]

• Bug 742095 - Missing documentation after nested C++11 unified initializer [ view ]

• Bug 742151 - Bogus warning: citelist: Unexpected new line character [ view ]

• Bug 742230 - @todo paragraphs incorrectly placed in rtf output [ view ]

• Bug 742235 - Bogus message with addtogroup [ view ]

• Bug 742408 - Configuring doxyfile to only output docbook produces erroneous warning [ view ]

• Bug 742427 - latex compilation: /backmatter incompatible with COMPACT_LATEX=YES [ view ]

• Bug 742445 - Wrong icons in TOC of CHM help [ view ]

• Bug 742899 - <CAPTION> inside <TABLE> no longer works for LaTex output [ view ]

• Bug 743604 - Duplicate anchors from tagfiles [ view ]

• Bug 743605 - Tagfile anchors not generated for enumeration values [ view ]

• Bug 743675 - Non-ascii characters are not emphasised [ view ]

• Bug 744762 - Using TAGFILES prevents symbol extraction [ view ]

• Bug 745439 - PATCH: please consider making doxygen output byte for byte identical between individual runs by default [ view ]

• Bug 745481 - Doxygen generates bad "More..." file links for functions within a namespace [ view ]

• Bug 745870 - [PATCH] QT4's qmake is titled differently on Fedora 21 [ view ], [ view ]

• Bug 746226 - last enum member not documented [ view ]

• Bug 746417 - Nested list in C# XML comments closes outer list prematurely [ view ], [ view ]

• Bug 746614 - Bogus warning regarding nested comments [ view ]

• Bug 746619 - Bogus warnings in case of anonymous namespace and @todo [ view ]

• Bug 746734 - Don't warn about missing documentation for deleted functions. [ view ], [ view ]

• Bug 747111 - Table of content incorrect with escaped symbols [ view ]

• Bug 747780 - man output should escape minus signs [ view ]

• Bug 748208 - Bug #313527 regression - Enum in bitfield is not parsed properly. [ view ], [ view ]

• Bug 750016 - FILE_PATTERNS ignores arbitrary extensions [ view ]

• Bug 751455 - class scoped enum documentation appearing at group level instead of class level [ view ]

• Build fixes for windows build [ view ]

• Bump copyright year [ view ]

• Bump version in configure script [ view ]

• Cleanup & adapt travis config [ view ]

• Consistency in handling HTML and LaTeX in respect to header and footer [ view ]

• Correct string buffer sizes for RTF output, such that the string is always correctly sized. [ view ]

• Crash in case of non generic interface in Fortran [ view ]

• Documentation HTML Header, Footer, and Stylesheet changes [ view ], [ view ]

• Documenting RESULT variable of Fortran FUNCTION [ view ], [ view ]

• Doxygen LaTeX / PDF links point to page 1 [ view ]

• Enable relative paths referenced source files [ view ]

• Escape "@" in names as it is not allowed in XML / Docbook names (comming from anon namespaces) [ view ]

• Fix for bug 746673. [ view ]

• Fix for building diagram example conditionally [ view ]

• Fix for issue 744670 [ view ]

• Fix for issue 744671 [ view ]

• Fix for rendering the template parameters of members of variadic template classes. [ view ]

• Fix missing brief documentation for overload and specialization functions [ view ]

• Fix nesting of XML tag "literallayout" for docbook output of enums. [ view ]

• Fix parsing of ODL-style properties [ view ]

• Fix potential null pointer dereference in src/classdef.cpp [ view ]

• Fix potential null pointer dereference in src/context.cpp [ view ]

• Fixed a couple of cases where sharing string data could lead to corruption [ view ]

• Fixed code reachability bug found by coverity in translator_fi.h [ view ]

• Fixed compilation issue on Windows [ view ]

• Fixed issue accessing uninitialized buffer under certain conditions. [ view ]

• Fixed potential crash while generating dot graphs [ view ]

• Fixed potential string buffer issue for dot graphs [ view ]

• Fixed regression due to buffer resizing while generating RTF. [ view ]

• Fixed regression in argument processing [ view ]

• Fixed type in printdocvisitor.h [ view ]

• Fixed typos in comments. [ view ]

• Fixes for showing type constraint relations [ view ]

• Fortran FUNCTION source code [ view ], [ view ]

• Fortran: code color GOTO as flow keyword. [ view ]

• Fortran: fixed format position 73 and further is comment [ view ], [ view ]

• Fortran: warning message about not documented module member [ view ]

• Guarded debug prints against printing a NULL pointer. [ view ]

• HTML entity &deg; gives problems in LaTeX [ view ]

• Help message regarding layout file [ view ],[ view ]

• Internal debug option -d lex is not described [ view ], [ view ]

• Internal doxygen docs gives: warning: Unsupported xml/html tag <...> found [ view ]

• Missing cross reference link [ view ]

• Patch fixing a typo in Pull Request 307 [ view ], [ view ]

• Prevent example.tag from being regenerated [ view ]

• Problem running tests under Windows [ view ]

• Remove the new line after @startuml in generated pu file [ view ]

• Remove unreachable code [ view ]

• Remove unused local and static global variables [ view ]

• Remove wrong </File> [ view ], [ view ]

• Removed OS version check for MACOSX (was not used anywhere) [ view ]

• Removed dbus XML parser, various refinements [ view ], [ view ]

• Removed old build files, added install targets and other options [ view ]

• Repair Doxygen generate invalid styleSheetFile and extensionsFile of RTF [ view ]

• Replace to_c_cmd by resource compiler [ view ]

• Restore deleted file [ view ]

• Showing grey/gray in documentation [ view ]

• Suggestion to use stripPrefix has been implemented for RESULT. For consistency also implemented for arguments. [ view ], [ view ]

• Support diff that returns "No differences encountered" when comparing test results [ view ]

• Support generating index-color PNG files [ view ]

• Switched back to version 6.2 of JavaCC for VHDL parser generation. [ view ]

• Tcl: fix for extra line breaks in source browser introduced by commit 312bef5 [ view ]

• TranslatorSwedish updated [ view ]

• Update of search from "endless search to 'Character search: criterion. [ view ]

• Update translator_cn.h [ view ]

• Updated changelog for 1.8.9.1 [ view ]

• Updated installation section of the manual [ view ]

• Various VHDL related fixes [ view ], [ view ], [ view ]

• Various minor changes [ view ]

• Warning message multiple mainpages [ view ]

• Warnings without filename [ view ]

• add support for github flavored fenced code blocks [ view ]

• added HHC.exe own output to the debug output when extcmd flag enabled [ view ]

• doc/translator.py -- minor updates [ view ]

• drop #include <unistd.h> [ view ]

• fix *.l for three backticks [ view ]

• fix enum brief description in RTF output [ view ]

• fix for CHM TOC "Classes" entry to point to annotated file [ view ]

• fix for src/translator_tw.h by Gary Lee (translation cleaned) [ view ]

• increase the size of l when result is modified [ view ]

• move layout_default.xml to templates/html/ [ view ]

• runtests.pl: mmn version has dash as separator [ view ]

• specify that doxygen searches files in INPUT tag [ view ]

• sqlite3: add regexp searches to search.py [ view ]

• sqlite3: add schema comments [ view ]

• sqlite3: fix constness [ view ]

• version.py pass configure file path as parameter [ view ]

• xml: use STRIP_FROM_PATH on @file attributes. [ view ], [ view ]

详细改进请看 更新日志 ，下载：

• doxygen-1.8.10.src.tar.gz(4.6MB)    ( ftp | http )

• doxygen-1.8.10.linux.bin.tar.gz(14.7MB)    ( ftp | http )

• doxygen-1.8.10-setup.exe(18.3MB)    ( ftp | http )

• Doxygen-1.8.10.dmg(56.0MB)    ( ftp | http )

Doxygen 是一个 C++, C, Java, Objective-C、Python、IDL (CORBA 和 Microsoft flavors)、Fortran、VHDL、PHP、C#和D语言的文档生成器。可以运行在大多数类Unix系统，以及Mac OS X操作系统和Microsoft Windows 。 初始版本的Doxygen借鉴了一些老版本DOC++的代码；随后，Doxygen源代码由Dimitri van Heesch重写。

Doxygen是一个编写软件参考文档的工具。 该文档是直接写在代码中，因此比较容易保持更新。 Doxygen 可以交叉引用文档和代码，使文件的读者可以很容易地引用实际的代码。