the appropriate tool via USE_TOOLS (usually "gs:run"), and remove
ghostscript.mk. This change removes a rather out-dated file from
pkgsrc and switches packages to use the more compact implementation
of the Ghostcript-handling inside the tools framework.
It is more consistent with the tex.buildlink3.mk name. Also, if a package
really needs latex, it just has to set TEX_ACCEPTED to latex distributions
altough today, all TEX_ACCEPTED possibilities are latex distributions
output filenames. This is problematic in a pkgsrc context as it means
WRKDIR pathnames can appear in generated filenames. Fix by reverting
to the old way of naming the files. Bump PKGREVISION.
New features
Added support for parsing Python code. Special comment blocks in Python
are of the ## # Some comment #
or you can rely on Python docstrings. This code uses the new parser
interface and was based on the work done by a group of students as part
of a compiler design project. Added support for C# style XML tags in the
comments. See the manual or the C# language specification for more
details. Thanks to Talin for doing most of the work. Added support for
the JavaDoc command {@inheritDoc}.
And some bug fixes. For details see:
http://www.stack.nl/~dimitri/doxygen/changelog.html
Doxygen Release 1.4.3
(release date 16-5-2005)
Changes
* For Developers: Added an abstract interface for language
parsers (see src/parserintf.h), which can be used implement
new programming language parsers. There is also a manager
class, where a parser instance can be bound to a certain
file extension.
* Changed the algorithm for matching function/method
declarations against their definitions. The new algorithm
should be faster, more powerful, and more accurate.
New features
* Included new config option HTAGS. When enabled in
combination with SOURCE_BROWSER=YES, the source browser of
GNU's Global source system (via htags) is used instead of
doxygen's own (thanks to Shigio Yamaguchi for the patch).
* Added language updates for Indonesian, Catalan, Russian,
Korean, German, Hungarian, Polish, and Lithuanian.
* Included update of the .spec file (thanks to Stephane
Gourichon).
Bug fixes (ids refer to the bugzilla database)
* id 163705: Using \image for latex without caption but with
size parameter "width=\textwidth" did not work.
* id 163783: Items of an autolist could be wrongly indented if
put directly after @name.
* id 163928: Class section was missing in the file
documentation.
* id 164072: When using tag files unneeded external classes
could appear in the class hierarchy in some cases.
* id 169755: page title was omitted in the XML output if
CASE_SENSE_NAME was set to NO.
* id 170592: Using \ref for Objective-C methods did not work
if the name contained a colon.
* id 171795: Refering to Objective-C methods now follows
Apple's conventions.
* id 171878: When JAVADOC_AUTOBRIEF = YES and there was no
blank line after a page command, the first sentence did not
appear in the documentation.
* id 171923: Doxygen failed to match arguments for a function
documentated out-of-line with @fn and using @relatesalso.
* id 172118: Doxywizard now shows the version of doxygen it is
for.
* id 172133: Doxygen did not longer ignore preceding C++
comments inside a comment block.
* id 172217: 'using namespace' declarations with spaces
resulted in duplicate namespaces.
* id 172329: The index of the CHM did not always link to
groups correctly.
* id 172456: Fixed case where doxygen had problems
differentiating const and non-const member functions.
* id 172494: @code blocks were not poperly ignored by the
preprocessor in some cases.
* id 172622: Fixed parse problem for Objective-C method
implementations whole declaration part ended with a
semicolon.
* id 172723: Namespace members appeared in the file
documentation without proper links to the namespace.
* id 172778: A single colon after retval caused a crash.
* id 172783: Doxygen will now put quotes around a filter name
before calling it so it will work with filters with spaces
in the name or path.
* id 172818: Improved translation of Todo List to German.
* id 172937: FILE_VERSION_FILTER failed for filenames
containing spaces.
* id 173034: The \elseif command was not handled properly.
* id 173110: \ingroup did not work with multiple group labels
anymore.
* id 300204: Doxygen disobeyed Cygwin's 'text/binary mount
mode' (thanks to Max Bowsher for the patch).
* id 300466: Improved the documentation for
FILTER_SOURCE_FILES.
* is 300473: Added a browse button for several of Doxywizard's
fields of the expert dialog where a file was expected.
* id 300532: consecutive @todo items were joined together even
if they are in different sections.
* id 300745: A disabled @cond section did not omit #define
documentation.
* is 301409: autolinks to undocumented files did not work
correctly when SOURCE_BROWSER was enabled.
* id 301437: Fixed a typo in an example that is part of the
preprocessor documentation.
* id 301478: Fixed some cases where cross-references were not
properly detected anymore.
* id 301616: Added "+" or "-" to the Objective-C method lists
in the summary section of a class.
* id 302100: An enum could not be grouped by grouping out of
line documentation.
* id 302158: When enabling SEPARATE_MEMBER_PAGES and
CREATE_SUBDIRS the member index contained invalid links.
* id 302160: list directly after @brief not parsed properly if
there were spaces before the @brief command.
* id 302713: Updated doxytag so it works better with recent
versions of Qt3 and the Qt4 beta versions.
* id 303305: When using \subpage the page hierarchy wasn't
reflected in the tree view or .chm index.
* id 303511: Documenting a class in a namespace with a comment
block inside the namespace containing a @class command did
not work properly.
* id 303911: Links from todo list items to Objective-C
categories were broken.
* id 304026: A class/struct/interface can now be turned into
something else of the same kind using the proper command
(i.e. @interface could by used to turn a class into an
interface).
* Doxygen did not honor the "All members of an interface in
Java are implicitly public" rule.
* An enum of a class could not be documented with @enum from
inside a namespace.
* Fixed problem handling unname member groups (useful in
combination with DISTRIBUTE_GROUP_DOC = YES, which didn't
work anymore).
* Updated Doxygen.dsp (thanks to Gerik Rhoden).
* For a word marked with a #, the # is now also removed when
no link could be generated.
* Using '<' (or '\<') in a <pre> section cause '$<$' to appear
in the Latex output.
Doxygen Release 1.4.2
(release date 28-3-2005)
Changes
* If the class/namespace/file member indexes get too long they
are now automatically split over multiple pages (one page
per index letter).
* Internal: I've split the input scanner (scanner.l) in a part
that scans the supported programming languages and passes
the comment blocks to a second scanner. This should clean up
the code a lot and make the handling of structural commands
(like \class and \section) more consistent. It is also a
first step towards supporting dedicated scanners for other
programming languages.
* Made doxygen parse .as files (Action Script) as Java code.
New features
* Added a new option SEPARATE_MEMBER_PAGES. When enabled
doxygen will generate a separate page for each documented
member, instead of putting all members on the
class/file/namespace page. An index for other members of the
same compound is rendered on the left hand side of the page.
* Added new command \subpage that can be used to build a
hierarchy of pages. For pages this is more convenient than
using \defgroup and \ingroup. See the documentation more
details and an example.
* Included man pages for doxygen and doxywizard.
* Language updates for Czech, Swedish, Russian, Italian,
Catalan, German, Brazilian, Korean, Ukrainian, Romanian,
Croatian and Chinese,
Bug fixes
* id 124214: #'s inside a single quoted PHP string could lead
to parse problems.
* id 142339: Doxygen did not using the LATEX_CMD_NAME setting
when generating formulas.
* id 163180: Extension specific filters did not work.
* id 163940: Labels in dot graphs containing quotes where not
escaped properly.
* id 164198: \overload text was always English, it is now
translatable.
* id 164498: Fixed problem where doxygen ignored the
documentation for members of Objective C class categories
when put in the implementation section.
* id 164563: \anchor didn't work inside a <pre>...</pre>
section.
* id 164812: fix compile problem for certain language
selections.
* id 165097: Fixed problem with wrong syntax color in \code
section.
* id 165188: in index.xsd the refid attribute type (xsd:Name)
was not broad enough and has been replaced by xsd:string.
* id 165339: Fixed some issues in the code parser causing
missed cross-referencing relations and/or call graphs.
* id 165428: ALIASES containing @section commands where not
handled properly.
* id 165503: grouped classes did not appear as such in the XML
output.
* id 165793: input filter was applied to \verbinclude.
* id 165816: Grouped functions referenced via tag files had
broken links
* id 165821: Tag file parser produced bogus errors for nested
classes and namespaces and no line number was reported.
* id 166043: static initializer block in Java made doxygen
ignore the rest of the file.
* id 166161: More documentation to make the \code command more
clear.
* id 166756: Fixed a number of issues with the new comment
scanner. It should be much more usable now.
* id 166782: XML output: Simple types in a namespace are also
listed at file scope in index.xml
* id 166863: @class required fully qualified name even if the
comment block was in the right scope already.
* id 166898: Forward declaring a template class added the
template argument to next class defined
* id 167037: The method names were non-informative in the todo
like lists when HIDE_SCOPE_NAMES was set to YES (thanks to
Luigi Ballabio for the fix).
* id 167040: Related functions were listed as members in the
todo list.
* id 167462: Doxygen doesn't recognize references to methods
of classes that come as parameter
* id 168159: Sometimes enums don't have hyperlinks in the
source code.
* id 168243: Doxygen produced an unclear warning when putting
multiple @page commands in one comment block.
* id 168693: A C-style comment ending with a brief description
(including dot) and a **/ as end marker, caused strange
warning.
* id 168734: Nested C comments in a \code block confused the
preprocessor.
* id 168754: //@{ was not working with the new comment block
scanner.
* id 168871: \~ did not work in C++ style documentation and
aliases.
* id 168961: Fixed problem parsing arrays of unnamed structs.
* id 169003: cross-references were make to global variables
even if the global variables were hidden by local ones or
undocumented/private member variables.
* id 169069: static C++ variables with initializers were
detected as functions.
* id 169188: static functions were not extracted from PHP
classes even though EXTRACT_STATIC was set to YES.
* id 169495: const Qt properties were not parsed properly.
* id 169535: spaces after \ref command were not preserved in
<pre> context when the command had only one argument.
* id 169547: Removed bogus warning for friend classes inside
classes in an anonymous namespace.
* id 169549: Previous fixes introduced flattening of the class
hierarchy.
* id 169640: File suffix check for the D language was broken.
* id 169641: D contructors and destructors were not detected.
* is 169657: Fixed the way import is treated in D to prevent
recursive lockup.
* id 169784: Objective-C methods with a variable number of
arguments were are not parsed properly.
* id 169789: Images specified via \image are now also copied
to the XML output.
* id 170612: documenting members of nested anonymous compounds
did no longer work.
* id 170833: <code> ended a brief description.
* id 170835: doxygen didn't match members of classes in
unnamed namespaces with their definitions
* id 170846: template instance friend classes could not be
documented externally.
* id 171260: In some cases doxygen produced an incorrect
warning about duplicate detailed descriptions.
* id 171295: It now possible again to link to a (enum)value of
a @retval using #name.
* id 171376: \else command was not properly parsed if the
corresponding \if was disabled.
* id 171749: Using @relatesalso for functions in a namespace
didn't work correctly.
* It is now possible again to use Thing%s to auto-link to a
class Thing and put a non-linked "s" after it.
* Nested anonymous namespaces appeared as @<num> in the
documentation of the parent namespace.
* aliases containing @brief were not handled correctly.
* The class name in the HtmlHelp index was linked to the first
member function of that class instead of the class itself.
* In the HTML help output (.chm files) the index items with only one subitem
are now collapsed into one item
* Some minor tweaks to the style sheet
* @relates can now not only be used for functions, but also for other members
* Static members do have have explicit "static" in the declaration part of
the documentation
* typedefs and enumeration are no longer shown in the "referenced by" list as
these are types
* Make configure script use solaris-g++ by default
(Sun's own compiler generates faulty code for doxygen)
* Included language update for Serbian, German, and Korean
* For directories dependency graphs are now generated
* Added \cond and \endcond commands, which can be used to (conditionally)
exclude a part of a file. See the manual for an example
* Added "-d ExtCmd" debug option, which when used shows what doxygen will
execute when invoking an external command (such as dot)
* New option WARN_NO_PARAMDOC that warns about the absence of function
parameter or return type documentation
* Nested classes are now listed in their containing class
* Extended the \f command to support different environments, i.e. \f{eqnarray*}
for equation arrays. The end command is \f}
* Added support for group dependency graphs
* New option DOT_TRANSPARENT to enable dot graph with a transparent background
* New option FILE_VERSION_FILTER which allows an external tool to provide
version information per file, which is then used in the file documentation
* id 162295: New option DOT_MULTI_TARGETS which when set to YES, will run dot
with multiple output files if possible
* Bug fixes
* Bug fixes
* 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).
Changes 1.3.9:
* 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.
* 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 ).
* Changed the way function pointer arguments are represented in the detailed
description.
* 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.
in the process. (More information on tech-pkg.)
Bump PKGREVISION and BUILDLINK_DEPENDS of all packages using libtool and
installing .la files.
Bump PKGREVISION (only) of all packages depending directly on the above
via a buildlink3 include.
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
* 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
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.
* 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
* Added internationalization support for Afrikaans and Lithanian. Included
language updates for Dutch, Czech, Italian, Brazilian, Croatian, Japanese,
Norwegian and Russian.
Bug fixes
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.
And many bug fixes. For a complete list see:
http://www.stack.nl/~dimitri/doxygen/changelog.html
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.
* STRIP_FROM_PATH now by default strips the path from which doxygen is run
New features
* Make a start with adding support for Objective-C. Doxygen can now parse
Objective-C header files (including protocols and categories).
* 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).
* 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.
* 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.
- teTeX 1.0.x packages have been moved to teTeX1* directories.
- teTeX 2.0.x packages have been moved to teTeX* directories and their base
name has been changed to teTeX (instead of teTeX2).
- Bug fixes
- New features
* 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.
doc/translator.pl, which has the side effect of allowing the docygen
package to be installed properly if you don't have '.' in your path.
Bump PKGREVISION.
all dependencies on packages depending on "png" which contain shared
libraries, all for the (imminent) update to the "png" package.
[List courtesy of John Darrow, courtesy of "bulk-build".]
Doxygen is a documentation system for C++, Java, IDL (Corba, Microsoft and
KDE-DCOP flavors) and C.
It can help you in three ways:
1. It can generate an on-line documentation browser (in HTML) and/or an
off-line reference manual (in LaTeX) from a set of documented source
files. There is also support for generating output in RTF (MS-Word),
PostScript, hyperlinked PDF, compressed HTML, and Unix man pages. The
documentation is extracted directly from the sources, which makes it
much easier to keep the documentation consistent with the source code.
2. Doxygen can be configured to extract the code structure from
undocumented source files. This can be very useful to quickly find your
way in large source distributions. The relations between the various
elements are be visualized by means of include dependency graphs,
inheritance diagrams, and collaboration diagrams, which are all
generated automatically.
3. You can even `abuse' doxygen for creating normal documentation
