Commit 77a2ce8e authored by dimitri's avatar dimitri

Release-1.3.3-20030824

parent d09056a7
...@@ -141,7 +141,7 @@ MAN_LINKS = NO ...@@ -141,7 +141,7 @@ MAN_LINKS = NO
#--------------------------------------------------------------------------- #---------------------------------------------------------------------------
# configuration options related to the XML output # configuration options related to the XML output
#--------------------------------------------------------------------------- #---------------------------------------------------------------------------
GENERATE_XML = NO GENERATE_XML = YES
#--------------------------------------------------------------------------- #---------------------------------------------------------------------------
# configuration options for the AutoGen Definitions output # configuration options for the AutoGen Definitions output
#--------------------------------------------------------------------------- #---------------------------------------------------------------------------
...@@ -188,9 +188,3 @@ DOT_CLEANUP = YES ...@@ -188,9 +188,3 @@ DOT_CLEANUP = YES
# Configuration::addtions related to the search engine # Configuration::addtions related to the search engine
#--------------------------------------------------------------------------- #---------------------------------------------------------------------------
SEARCHENGINE = NO SEARCHENGINE = NO
CGI_NAME = search.cgi
CGI_URL =
DOC_URL =
DOC_ABSPATH =
BIN_ABSPATH = /usr/local/bin/
EXT_DOC_PATHS =
DOXYGEN Version 1.3.3-20030808 DOXYGEN Version 1.3.3-20030824
Please read the installation section of the manual Please read the installation section of the manual
(http://www.doxygen.org/install.html) for instructions. (http://www.doxygen.org/install.html) for instructions.
-------- --------
Dimitri van Heesch (08 August 2003) Dimitri van Heesch (24 August 2003)
DOXYGEN Version 1.3.3_20030808 DOXYGEN Version 1.3.3_20030824
Please read INSTALL for compilation instructions. Please read INSTALL for compilation instructions.
...@@ -17,4 +17,4 @@ to subscribe to the lists or to visit the archives. ...@@ -17,4 +17,4 @@ to subscribe to the lists or to visit the archives.
Enjoy, Enjoy,
Dimitri van Heesch (dimitri@stack.nl) (08 August 2003) Dimitri van Heesch (dimitri@stack.nl) (24 August 2003)
1.3.3-20030808 1.3.3-20030824
...@@ -450,6 +450,8 @@ ConfigFile::ConfigFile( QWidget *parent ) : QWidget( parent ) ...@@ -450,6 +450,8 @@ ConfigFile::ConfigFile( QWidget *parent ) : QWidget( parent )
addDependency(m_switches,option->dependsOn(),option->name()); addDependency(m_switches,option->dependsOn(),option->name());
} }
break; break;
case ConfigOption::O_Obsolete:
break;
} }
} }
if (page) page->addStretch(1); if (page) page->addStretch(1);
......
...@@ -34,7 +34,7 @@ IMAGE_PATH = . ...@@ -34,7 +34,7 @@ IMAGE_PATH = .
INPUT = index.doc install.doc starting.doc docblocks.doc lists.doc \ INPUT = index.doc install.doc starting.doc docblocks.doc lists.doc \
grouping.doc formulas.doc diagrams.doc preprocessing.doc \ grouping.doc formulas.doc diagrams.doc preprocessing.doc \
external.doc faq.doc trouble.doc history.doc features.doc \ external.doc faq.doc trouble.doc history.doc features.doc \
doxygen_usage.doc doxytag_usage.doc doxysearch_usage.doc \ doxygen_usage.doc doxytag_usage.doc \
doxywizard_usage.doc \ doxywizard_usage.doc \
installdox_usage.doc output.doc autolink.doc \ installdox_usage.doc output.doc autolink.doc \
config.doc commands.doc htmlcmds.doc language.doc \ config.doc commands.doc htmlcmds.doc language.doc \
...@@ -46,11 +46,5 @@ TAGFILES = ...@@ -46,11 +46,5 @@ TAGFILES =
ALLEXTERNALS = NO ALLEXTERNALS = NO
PERL_PATH = /usr/local/bin/perl PERL_PATH = /usr/local/bin/perl
SEARCHENGINE = NO SEARCHENGINE = NO
CGI_NAME = search.cgi
CGI_URL =
DOC_URL =
DOC_ABSPATH =
BIN_ABSPATH = /usr/local/bin/
EXT_DOC_PATHS =
PDF_HYPERLINKS = YES PDF_HYPERLINKS = YES
USE_PDFLATEX = YES USE_PDFLATEX = YES
...@@ -107,6 +107,7 @@ documentation: ...@@ -107,6 +107,7 @@ documentation:
\refitem cmdpre \\pre \refitem cmdpre \\pre
\refitem cmdref \\ref \refitem cmdref \\ref
\refitem cmdrelates \\relates \refitem cmdrelates \\relates
\refitem cmdrelatesalso \\relatesalso
\refitem cmdremarks \\remarks \refitem cmdremarks \\remarks
\refitem cmdreturn \\return \refitem cmdreturn \\return
\refitem cmdretval \\retval \refitem cmdretval \\retval
...@@ -552,6 +553,24 @@ See section \ref memgroup for an example. ...@@ -552,6 +553,24 @@ See section \ref memgroup for an example.
for the corresponding HTML documentation that is generated by doxygen. for the corresponding HTML documentation that is generated by doxygen.
\endhtmlonly \endhtmlonly
<hr>
\section cmdrelatesalso \relatesalso <name>
\addindex \\relatesalso
This command can be used in the documentation of a non-member function
\<name\>. It puts the function both inside the `related function' section
of the class documentation as well as leaving its normal file documentation
location. This command is useful for documenting
non-friend functions that are nevertheless strongly coupled to a certain
class. It only works for functions.
\par Example:
\verbinclude relates.cpp
\htmlonly
Click <a href="$(DOXYGEN_DOCDIR)/examples/relates/html/globals.html">here</a>
for the corresponding HTML documentation that is generated by doxygen.
\endhtmlonly
<hr> <hr>
\section cmdshowinitializer \showinitializer \section cmdshowinitializer \showinitializer
......
...@@ -59,13 +59,10 @@ followed by the descriptions of the tags grouped by category. ...@@ -59,13 +59,10 @@ followed by the descriptions of the tags grouped by category.
\refitem cfg_allexternals ALLEXTERNALS \refitem cfg_allexternals ALLEXTERNALS
\refitem cfg_alphabetical_index ALPHABETICAL_INDEX \refitem cfg_alphabetical_index ALPHABETICAL_INDEX
\refitem cfg_always_detailed_sec ALWAYS_DETAILED_SEC \refitem cfg_always_detailed_sec ALWAYS_DETAILED_SEC
\refitem cfg_bin_abspath BIN_ABSPATH
\refitem cfg_binary_toc BINARY_TOC \refitem cfg_binary_toc BINARY_TOC
\refitem cfg_brief_member_desc BRIEF_MEMBER_DESC \refitem cfg_brief_member_desc BRIEF_MEMBER_DESC
\refitem cfg_call_graph CALL_GRAPH \refitem cfg_call_graph CALL_GRAPH
\refitem cfg_case_sense_names CASE_SENSE_NAMES \refitem cfg_case_sense_names CASE_SENSE_NAMES
\refitem cfg_cgi_name CGI_NAME
\refitem cfg_cgi_url CGI_URL
\refitem cfg_chm_file CHM_FILE \refitem cfg_chm_file CHM_FILE
\refitem cfg_class_diagrams CLASS_DIAGRAMS \refitem cfg_class_diagrams CLASS_DIAGRAMS
\refitem cfg_class_graph CLASS_GRAPH \refitem cfg_class_graph CLASS_GRAPH
...@@ -76,8 +73,6 @@ followed by the descriptions of the tags grouped by category. ...@@ -76,8 +73,6 @@ followed by the descriptions of the tags grouped by category.
\refitem cfg_details_at_top DETAILS_AT_TOP \refitem cfg_details_at_top DETAILS_AT_TOP
\refitem cfg_disable_index DISABLE_INDEX \refitem cfg_disable_index DISABLE_INDEX
\refitem cfg_distribute_group_doc DISTRIBUTE_GROUP_DOC \refitem cfg_distribute_group_doc DISTRIBUTE_GROUP_DOC
\refitem cfg_doc_abspath DOC_ABSPATH
\refitem cfg_doc_url DOC_URL
\refitem cfg_dot_image_format DOT_IMAGE_FORMAT \refitem cfg_dot_image_format DOT_IMAGE_FORMAT
\refitem cfg_dot_path DOT_PATH \refitem cfg_dot_path DOT_PATH
\refitem cfg_dotfile_dirs DOTFILE_DIRS \refitem cfg_dotfile_dirs DOTFILE_DIRS
...@@ -92,7 +87,6 @@ followed by the descriptions of the tags grouped by category. ...@@ -92,7 +87,6 @@ followed by the descriptions of the tags grouped by category.
\refitem cfg_exclude_symlinks EXCLUDE_SYMLINKS \refitem cfg_exclude_symlinks EXCLUDE_SYMLINKS
\refitem cfg_expand_as_defined EXPAND_AS_DEFINED \refitem cfg_expand_as_defined EXPAND_AS_DEFINED
\refitem cfg_expand_only_predef EXPAND_ONLY_PREDEF \refitem cfg_expand_only_predef EXPAND_ONLY_PREDEF
\refitem cfg_ext_doc_paths EXT_DOC_PATHS
\refitem cfg_external_groups EXTERNAL_GROUPS \refitem cfg_external_groups EXTERNAL_GROUPS
\refitem cfg_extra_packages EXTRA_PACKAGES \refitem cfg_extra_packages EXTRA_PACKAGES
\refitem cfg_extract_all EXTRACT_ALL \refitem cfg_extract_all EXTRACT_ALL
...@@ -209,7 +203,7 @@ followed by the descriptions of the tags grouped by category. ...@@ -209,7 +203,7 @@ followed by the descriptions of the tags grouped by category.
\refitem cfg_xml_schema XML_SCHEMA \refitem cfg_xml_schema XML_SCHEMA
\endsecreflist \endsecreflist
\section config_general General options \section config_project Project related options
\anchor cfg_project_name \anchor cfg_project_name
<dl> <dl>
...@@ -258,72 +252,6 @@ followed by the descriptions of the tags grouped by category. ...@@ -258,72 +252,6 @@ followed by the descriptions of the tags grouped by category.
whereas setting the tag to \c NO uses a Unix-style encoding (the default for whereas setting the tag to \c NO uses a Unix-style encoding (the default for
all platforms other than Windows). all platforms other than Windows).
\anchor cfg_extract_all
<dt>\c EXTRACT_ALL <dd>
\addindex EXTRACT_ALL
If the \c EXTRACT_ALL tag is set to \c YES doxygen will assume all
entities in documentation are documented, even if no documentation was
available. Private class members and static file members will be hidden
unless the \c EXTRACT_PRIVATE and \c EXTRACT_STATIC tags are set to \c YES
\par Note:
This will also disable the warnings about undocumented members
that are normally produced when \c WARNINGS is set to \c YES
\anchor cfg_extract_private
<dt>\c EXTRACT_PRIVATE <dd>
\addindex EXTRACT_PRIVATE
If the \c EXTRACT_PRIVATE tag is set to \c YES all private members of a
class will be included in the documentation.
\anchor cfg_extract_static
<dt>\c EXTRACT_STATIC <dd>
\addindex EXTRACT_STATIC
If the \c EXTRACT_STATIC tag is set to \c YES all static members of a file
will be included in the documentation.
\anchor cfg_extract_local_classes
<dt>\c EXTRACT_LOCAL_CLASSES <dd>
\addindex EXTRACT_LOCAL_CLASSES
If the \c EXTRACT_LOCAL_CLASSES tag is set to \c YES classes (and structs)
defined locally in source files will be included in the documentation.
If set to NO only classes defined in header files are included. Does not
have any effect for Java sources.
\anchor cfg_hide_undoc_members
<dt>\c HIDE_UNDOC_MEMBERS <dd>
\addindex HIDE_UNDOC_MEMBERS
If the \c HIDE_UNDOC_MEMBERS tag is set to \c YES, doxygen will hide all
undocumented members inside documented classes or files.
If set to \c NO (the default) these members will be included in the
various overviews, but no documentation section is generated.
This option has no effect if \c EXTRACT_ALL is enabled.
\anchor cfg_hide_undoc_classes
<dt>\c HIDE_UNDOC_CLASSES <dd>
\addindex HIDE_UNDOC_CLASSES
If the \c HIDE_UNDOC_CLASSESS tag is set to \c YES, doxygen will hide all
undocumented classes.
If set to \c NO (the default) these classes will be included in the
various overviews.
This option has no effect if \c EXTRACT_ALL is enabled.
\anchor cfg_hide_friend_compounds
<dt>\c HIDE_FRIEND_COMPOUNDS <dd>
\addindex HIDE_FRIEND_COMPOUNDS
If the \c HIDE_FRIEND_COMPOUNDS tag is set to \c YES, Doxygen will hide all
friend (class|struct|union) declarations.
If set to \c NO (the default) these declarations will be included in the
documentation.
\anchor cfg_hide_in_body_docs
<dt>\c HIDE_IN_BODY_DOCS <dd>
\addindex HIDE_IN_BODY_DOCS
If the \c HIDE_IN_BODY_DOCS tag is set to \c YES, Doxygen will hide any
documentation blocks found inside the body of a function.
If set to \c NO (the default) these blocks will be appended to the
function's detailed documentation block.
\anchor cfg_brief_member_desc \anchor cfg_brief_member_desc
<dt>\c BRIEF_MEMBER_DESC <dd> <dt>\c BRIEF_MEMBER_DESC <dd>
\addindex BRIEF_MEMBER_DESC \addindex BRIEF_MEMBER_DESC
...@@ -373,14 +301,6 @@ function's detailed documentation block. ...@@ -373,14 +301,6 @@ function's detailed documentation block.
only done if one of the specified strings matches the left-hand part of the only done if one of the specified strings matches the left-hand part of the
path. path.
\anchor cfg_internal_docs
<dt>\c INTERNAL_DOCS <dd>
\addindex INTERNAL_DOCS
The \c INTERNAL_DOCS tag determines if documentation
that is typed after a \ref cmdinternal "\\internal" command is included. If the tag is set
to \c NO (the default) then the documentation will be excluded.
Set it to \c YES to include the internal documentation.
\anchor cfg_case_sense_names \anchor cfg_case_sense_names
<dt>\c CASE_SENSE_NAMES <dd> <dt>\c CASE_SENSE_NAMES <dd>
\addindex CASE_SENSE_NAMES \addindex CASE_SENSE_NAMES
...@@ -397,13 +317,6 @@ function's detailed documentation block. ...@@ -397,13 +317,6 @@ function's detailed documentation block.
(but less readable) file names. This can be useful is your file systems (but less readable) file names. This can be useful is your file systems
doesn't support long names like on DOS, Mac, or CD-ROM. doesn't support long names like on DOS, Mac, or CD-ROM.
\anchor cfg_hide_scope_names
<dt>\c HIDE_SCOPE_NAMES <dd>
\addindex HIDE_SCOPE_NAMES
If the \c HIDE_SCOPE_NAMES tag is set to \c NO (the default) then doxygen
will show members with their full class and namespace scopes in the
documentation. If set to \c YES the scope will be hidden.
\anchor cfg_verbatim_headers \anchor cfg_verbatim_headers
<dt>\c VERBATIM_HEADERS <dd> <dt>\c VERBATIM_HEADERS <dd>
\addindex VERBATIM_HEADERS \addindex VERBATIM_HEADERS
...@@ -412,13 +325,6 @@ function's detailed documentation block. ...@@ -412,13 +325,6 @@ function's detailed documentation block.
which an include is specified. Set to NO to disable this. which an include is specified. Set to NO to disable this.
\sa Section \ref cmdclass "\\class". \sa Section \ref cmdclass "\\class".
\anchor cfg_show_include_files
<dt>\c SHOW_INCLUDE_FILES <dd>
\addindex SHOW_INCLUDE_FILES
If the SHOW_INCLUDE_FILES tag is set to YES (the default) then doxygen
will put a list of the files that are included by a file in the documentation
of that file.
\anchor cfg_javadoc_autobrief \anchor cfg_javadoc_autobrief
<dt>\c JAVADOC_AUTOBRIEF <dd> <dt>\c JAVADOC_AUTOBRIEF <dd>
\addindex JAVADOC_AUTOBRIEF \addindex JAVADOC_AUTOBRIEF
...@@ -453,20 +359,6 @@ function's detailed documentation block. ...@@ -453,20 +359,6 @@ function's detailed documentation block.
member inherits the documentation from any documented member that it member inherits the documentation from any documented member that it
reimplements. reimplements.
\anchor cfg_inline_info
<dt>\c INLINE_INFO <dd>
\addindex INLINE_INFO
If the \c INLINE_INFO tag is set to \c YES (the default) then a tag [inline]
is inserted in the documentation for inline members.
\anchor cfg_sort_member_docs
<dt>\c SORT_MEMBER_DOCS <dd>
\addindex SORT_MEMBER_DOCS
If the \c SORT_MEMBER_DOCS tag is set to \c YES (the default) then doxygen
will sort the (detailed) documentation of file and class members
alphabetically by member name. If set to \c NO the members will appear in
declaration order.
\anchor cfg_distribute_group_doc \anchor cfg_distribute_group_doc
<dt>\c DISTRIBUTE_GROUP_DOC <dd> <dt>\c DISTRIBUTE_GROUP_DOC <dd>
\addindex DISTRIBUTE_GROUP_DOC \addindex DISTRIBUTE_GROUP_DOC
...@@ -481,12 +373,154 @@ function's detailed documentation block. ...@@ -481,12 +373,154 @@ function's detailed documentation block.
the \c TAB_SIZE tag can be used to set the number of spaces in a tab. the \c TAB_SIZE tag can be used to set the number of spaces in a tab.
Doxygen uses this value to replace tabs by spaces in code fragments. Doxygen uses this value to replace tabs by spaces in code fragments.
\anchor cfg_enabled_sections \anchor cfg_aliases
<dt>\c ENABLED_SECTIONS <dd> <dt>\c ALIASES <dd>
\addindex ENABLED_SECTIONS \addindex ALIASES
The \c ENABLED_SECTIONS tag can be used to enable conditional This tag can be used to specify a number of aliases that acts
documentation sections, marked by \ref cmdif "\\if" \<section-label\> ... as commands in the documentation. An alias has the form
\ref cmdendif "\\endif" blocks. \verbatim
name=value
\endverbatim
For example adding
\verbatim
"sideeffect=\par Side Effects:\n"
\endverbatim
will allow you to
put the command \\sideeffect (or \@sideeffect) in the documentation, which
will result in a user-defined paragraph with heading "Side Effects:".
You can put \\n's in the value part of an alias to insert newlines.
\anchor cfg_optimize_output_for_c
<dt>\c OPTIMIZE_OUTPUT_FOR_C <dd>
\addindex OPTIMIZE_OUTPUT_FOR_C
Set the \c OPTIMIZE_OUTPUT_FOR_C tag to \c YES if your project consists
of C sources only. Doxygen will then generate output that is more tailored
for C. For instance, some of the names that are used will be different.
The list of all members will be omitted, etc.
\anchor cfg_optimize_output_java
<dt>\c OPTIMIZE_OUTPUT_JAVA <dd>
\addindex OPTIMIZE_OUTPUT_JAVA
Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java sources
only. Doxygen will then generate output that is more tailored for Java.
For instance, namespaces will be presented as packages, qualified scopes
will look different, etc.
\anchor cfg_subgrouping
<dt>\c SUBGROUPING <dd>
\addindex SUBGROUPING
Set the \c SUBGROUPING tag to \c YES (the default) to allow class member groups of
the same type (for instance a group of public functions) to be put as a
subgroup of that type (e.g. under the Public Functions section). Set it to
\c NO to prevent subgrouping. Alternatively, this can be done per class using
the \ref cmdnosubgrouping "\\nosubgrouping" command.
</dl>
\section config_build Build related options
\anchor cfg_extract_all
<dl>
<dt>\c EXTRACT_ALL <dd>
\addindex EXTRACT_ALL
If the \c EXTRACT_ALL tag is set to \c YES doxygen will assume all
entities in documentation are documented, even if no documentation was
available. Private class members and static file members will be hidden
unless the \c EXTRACT_PRIVATE and \c EXTRACT_STATIC tags are set to \c YES
\par Note:
This will also disable the warnings about undocumented members
that are normally produced when \c WARNINGS is set to \c YES
\anchor cfg_extract_private
<dt>\c EXTRACT_PRIVATE <dd>
\addindex EXTRACT_PRIVATE
If the \c EXTRACT_PRIVATE tag is set to \c YES all private members of a
class will be included in the documentation.
\anchor cfg_extract_static
<dt>\c EXTRACT_STATIC <dd>
\addindex EXTRACT_STATIC
If the \c EXTRACT_STATIC tag is set to \c YES all static members of a file
will be included in the documentation.
\anchor cfg_extract_local_classes
<dt>\c EXTRACT_LOCAL_CLASSES <dd>
\addindex EXTRACT_LOCAL_CLASSES
If the \c EXTRACT_LOCAL_CLASSES tag is set to \c YES classes (and structs)
defined locally in source files will be included in the documentation.
If set to NO only classes defined in header files are included. Does not
have any effect for Java sources.
\anchor cfg_hide_undoc_members
<dt>\c HIDE_UNDOC_MEMBERS <dd>
\addindex HIDE_UNDOC_MEMBERS
If the \c HIDE_UNDOC_MEMBERS tag is set to \c YES, doxygen will hide all
undocumented members inside documented classes or files.
If set to \c NO (the default) these members will be included in the
various overviews, but no documentation section is generated.
This option has no effect if \c EXTRACT_ALL is enabled.
\anchor cfg_hide_undoc_classes
<dt>\c HIDE_UNDOC_CLASSES <dd>
\addindex HIDE_UNDOC_CLASSES
If the \c HIDE_UNDOC_CLASSESS tag is set to \c YES, doxygen will hide all
undocumented classes.
If set to \c NO (the default) these classes will be included in the
various overviews.
This option has no effect if \c EXTRACT_ALL is enabled.
\anchor cfg_hide_friend_compounds
<dt>\c HIDE_FRIEND_COMPOUNDS <dd>
\addindex HIDE_FRIEND_COMPOUNDS
If the \c HIDE_FRIEND_COMPOUNDS tag is set to \c YES, Doxygen will hide all
friend (class|struct|union) declarations.
If set to \c NO (the default) these declarations will be included in the
documentation.
\anchor cfg_hide_in_body_docs
<dt>\c HIDE_IN_BODY_DOCS <dd>
\addindex HIDE_IN_BODY_DOCS
If the \c HIDE_IN_BODY_DOCS tag is set to \c YES, Doxygen will hide any
documentation blocks found inside the body of a function.
If set to \c NO (the default) these blocks will be appended to the
function's detailed documentation block.
\anchor cfg_internal_docs
<dt>\c INTERNAL_DOCS <dd>
\addindex INTERNAL_DOCS
The \c INTERNAL_DOCS tag determines if documentation
that is typed after a \ref cmdinternal "\\internal" command is included. If the tag is set
to \c NO (the default) then the documentation will be excluded.
Set it to \c YES to include the internal documentation.
\anchor cfg_hide_scope_names
<dt>\c HIDE_SCOPE_NAMES <dd>
\addindex HIDE_SCOPE_NAMES
If the \c HIDE_SCOPE_NAMES tag is set to \c NO (the default) then doxygen
will show members with their full class and namespace scopes in the
documentation. If set to \c YES the scope will be hidden.
\anchor cfg_show_include_files
<dt>\c SHOW_INCLUDE_FILES <dd>
\addindex SHOW_INCLUDE_FILES
If the SHOW_INCLUDE_FILES tag is set to YES (the default) then doxygen
will put a list of the files that are included by a file in the documentation
of that file.
\anchor cfg_inline_info
<dt>\c INLINE_INFO <dd>
\addindex INLINE_INFO
If the \c INLINE_INFO tag is set to \c YES (the default) then a tag [inline]
is inserted in the documentation for inline members.
\anchor cfg_sort_member_docs
<dt>\c SORT_MEMBER_DOCS <dd>
\addindex SORT_MEMBER_DOCS
If the \c SORT_MEMBER_DOCS tag is set to \c YES (the default) then doxygen
will sort the (detailed) documentation of file and class members
alphabetically by member name. If set to \c NO the members will appear in
declaration order.
\anchor cfg_generate_deprecatedlist \anchor cfg_generate_deprecatedlist
<dt>\c GENERATE_DEPRECATEDLIST <dd> <dt>\c GENERATE_DEPRECATEDLIST <dd>
...@@ -518,22 +552,12 @@ function's detailed documentation block. ...@@ -518,22 +552,12 @@ function's detailed documentation block.
disable (NO) the bug list. This list is created by disable (NO) the bug list. This list is created by
putting \ref cmdbug "\\bug" commands in the documentation. putting \ref cmdbug "\\bug" commands in the documentation.
\anchor cfg_aliases \anchor cfg_enabled_sections
<dt>\c ALIASES <dd> <dt>\c ENABLED_SECTIONS <dd>
\addindex ALIASES \addindex ENABLED_SECTIONS
This tag can be used to specify a number of aliases that acts The \c ENABLED_SECTIONS tag can be used to enable conditional
as commands in the documentation. An alias has the form documentation sections, marked by \ref cmdif "\\if" \<section-label\> ...
\verbatim \ref cmdendif "\\endif" blocks.
name=value
\endverbatim
For example adding
\verbatim
"sideeffect=\par Side Effects:\n"
\endverbatim
will allow you to
put the command \\sideeffect (or \@sideeffect) in the documentation, which
will result in a user-defined paragraph with heading "Side Effects:".
You can put \\n's in the value part of an alias to insert newlines.
\anchor cfg_max_initializer_lines \anchor cfg_max_initializer_lines
<dt>\c MAX_INITIALIZER_LINES <dd> <dt>\c MAX_INITIALIZER_LINES <dd>
...@@ -545,22 +569,6 @@ function's detailed documentation block. ...@@ -545,22 +569,6 @@ function's detailed documentation block.
individual variables and defines can be controlled using \ref cmdshowinitializer "\\showinitializer" individual variables and defines can be controlled using \ref cmdshowinitializer "\\showinitializer"
or \ref cmdhideinitializer "\\hideinitializer" command in the documentation. or \ref cmdhideinitializer "\\hideinitializer" command in the documentation.
\anchor cfg_optimize_output_for_c
<dt>\c OPTIMIZE_OUTPUT_FOR_C <dd>
\addindex OPTIMIZE_OUTPUT_FOR_C
Set the \c OPTIMIZE_OUTPUT_FOR_C tag to \c YES if your project consists
of C sources only. Doxygen will then generate output that is more tailored
for C. For instance, some of the names that are used will be different.
The list of all members will be omitted, etc.
\anchor cfg_optimize_output_java
<dt>\c OPTIMIZE_OUTPUT_JAVA <dd>
\addindex OPTIMIZE_OUTPUT_JAVA
Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java sources
only. Doxygen will then generate output that is more tailored for Java.
For instance, namespaces will be presented as packages, qualified scopes
will look different, etc.
\anchor cfg_show_used_files \anchor cfg_show_used_files
<dt>\c SHOW_USED_FILES <dd> <dt>\c SHOW_USED_FILES <dd>
\addindex SHOW_USED_FILES \addindex SHOW_USED_FILES
...@@ -568,15 +576,6 @@ function's detailed documentation block. ...@@ -568,15 +576,6 @@ function's detailed documentation block.
at the bottom of the documentation of classes and structs. If set to \c YES the at the bottom of the documentation of classes and structs. If set to \c YES the
list will mention the files that were used to generate the documentation. list will mention the files that were used to generate the documentation.
\anchor cfg_subgrouping
<dt>\c SUBGROUPING <dd>
\addindex SUBGROUPING
Set the \c SUBGROUPING tag to \c YES (the default) to allow class member groups of
the same type (for instance a group of public functions) to be put as a
subgroup of that type (e.g. under the Public Functions section). Set it to
\c NO to prevent subgrouping. Alternatively, this can be done per class using
the \ref cmdnosubgrouping "\\nosubgrouping" command.
</dl> </dl>
\section messages_input Options related to warning and progress messages \section messages_input Options related to warning and progress messages
...@@ -1568,52 +1567,13 @@ remove the intermediate dot files that are used to generate the various graphs. ...@@ -1568,52 +1567,13 @@ remove the intermediate dot files that are used to generate the various graphs.
<dt>\c SEARCHENGINE <dd> <dt>\c SEARCHENGINE <dd>
\addindex SEARCHENGINE \addindex SEARCHENGINE
The \c SEARCHENGINE tag specifies whether or not a The \c SEARCHENGINE tag specifies whether or not the HTML output should
search should be used. Possible values are \c YES and \c NO. contain a search facility. Possible values are \c YES and \c NO.
If set to \c NO or left blank, the values of all other tags in this section If set to YES, doxygen will produce a search index and a PHP script
will be ignored. to search through the index. For this to work the documentation should
be viewed via a web-server running PHP version 4.1.0 or higher.
\anchor cfg_cgi_name (See http://www.php.net/manual/en/installation.php for installation
<dt>\c CGI_NAME <dd> instructions).
\addindex CGI_NAME
The \c CGI_NAME tag should be the name of the CGI script that
starts the search engine (<tt>doxysearch</tt>) with the correct parameters.
A script with this name will be generated by doxygen.
\anchor cfg_cgi_url
<dt>\c CGI_URL <dd>
\addindex CGI_URL
The \c CGI_URL tag should be the absolute URL to the directory where the
cgi binaries are located. See the documentation of your HTTP daemon for
details.
\anchor cfg_doc_url
<dt>\c DOC_URL <dd>
\addindex DOC_URL
The \c DOC_URL tag should be the absolute URL to the directory where the
documentation is located. If left blank the absolute path to the
documentation, with \c file:// prepended to it, will be used.
This is correct for local viewing only.
\anchor cfg_doc_abspath
<dt>\c DOC_ABSPATH <dd>
\addindex DOC_ABSPATH
The \c DOC_ABSPATH tag should be the absolute path to the directory where the
documentation is located. If left blank the directory on the local machine
will be used.
\anchor cfg_bin_abspath
<dt>\c BIN_ABSPATH <dd>
\addindex BIN_ABSPATH
The \c BIN_ABSPATH tag must point to the directory where the doxysearch binary
is installed.
\anchor cfg_ext_doc_paths
<dt>\c EXT_DOC_PATHS <dd>
\addindex EXT_DOC_PATHS
The \c EXT_DOC_PATHS tag can be used to specify one or more paths to
documentation generated for other projects. This allows doxysearch to search
the documentation for these projects as well. All paths must be absolute.
</dl> </dl>
<h2>Examples</h2> <h2>Examples</h2>
...@@ -1649,11 +1609,6 @@ INCLUDE_PATH = examples ...@@ -1649,11 +1609,6 @@ INCLUDE_PATH = examples
TAGFILES = qt.tag TAGFILES = qt.tag
PERL_PATH = /usr/local/bin/perl PERL_PATH = /usr/local/bin/perl
SEARCHENGINE = YES SEARCHENGINE = YES
CGI_NAME = search.cgi
CGI_URL = http://www.stack.nl/~dimitri/cgi-bin
DOC_URL = http://www.stack.nl/~dimitri/qdbttabular
DOC_ABSPATH = /home/dimitri/.html/qdbttabular
BIN_ABSPATH = /home/dimitri/bin
\endverbatim \endverbatim
To regenerate the Qt-1.44 documentation from the sources, you could use the To regenerate the Qt-1.44 documentation from the sources, you could use the
......
...@@ -91,7 +91,4 @@ doxygen -w rtf rtfstyle.cfg ...@@ -91,7 +91,4 @@ doxygen -w rtf rtfstyle.cfg
a file, use \c - for the file name. a file, use \c - for the file name.
</ul> </ul>
If you also want to use the search engine, you should look
at section \ref doxysearch_usage.
*/ */
...@@ -17,38 +17,26 @@ ...@@ -17,38 +17,26 @@
/*! \page doxytag_usage Doxytag usage /*! \page doxytag_usage Doxytag usage
Doxytag is a small command line based utility. Doxytag is a small command line based utility.
It has two functions: It can generate <em>tag files</em>.
<ul> These tag files can be used with <a href="doxygen_usage.html">doxygen</a>
<li> to generate references to external documentation
Doxytag can generate <em>tag files</em>. (i.e. documentation not contained in the input files that are used by
These tag files can be used with <a href="doxygen_usage.html">doxygen</a> doxygen).
to generate references to external documentation
(i.e. documentation not contained in the input files that are used by A tag file contains information about files, classes and members
doxygen). documented in external documentation. Doxytag extracts this information
A tag file contains information about files, classes and members directly from the HTML files. This has the advantage that you do not need
documented in external documentation. Doxytag extracts this information to have the sources from which the documentation was extracted.
directly from the HTML files. This has the advantage that you do not need
to have the sources from which the documentation was extracted. If you \e do have the sources it is better to let \c doxygen generate the
If you \e do have the sources it is better to let \c doxygen generate the tag file by putting the name of the tag file after
tag file by putting the name of the tag file after \ref cfg_generate_tagfile "GENERATE_TAGFILE" in
\ref cfg_generate_tagfile "GENERATE_TAGFILE" in the configuration file.
the configuration file.
<li> The input of doxytag consists of a set of HTML files.
Doxytag can generate a <em>search index</em> for the documentation
generated with doxygen or for the Qt documentation. See the documentation of
<a href="doxysearch_usage.html">doxysearch</a> for more information on how
to do this.
A search index contains information about all the words (and all substrings
thereof) that are contained in the documentation.
For each string the index contains the set of documentation blocks that
contain the string and the frequency of occurrence. This way
<code>doxysearch</code> can search for words very quickly
(most queries are processed within a few milliseconds on my system.)
</ul>
In both cases the input of doxytag consists of a set of HTML files.
\par Important: \par Important:
If you use tag files or use a search engine, the links that If you use tag files, the links that
are generated by doxygen will contain \e dummy links. You have to run are generated by doxygen will contain \e dummy links. You have to run
the \c installdox script to change these dummy links into real links. the \c installdox script to change these dummy links into real links.
See \ref installdox_usage for more information. See \ref installdox_usage for more information.
...@@ -58,10 +46,10 @@ In both cases the input of doxytag consists of a set of HTML files. ...@@ -58,10 +46,10 @@ In both cases the input of doxytag consists of a set of HTML files.
only \c installdox has to be run. only \c installdox has to be run.
\par Note: \par Note:
Because the HTML files are expected to have a certain Because the HTML files are expected to have a certain
structure, only HTML files generated with doxygen or with Qt's class structure, only HTML files generated with doxygen or with Qt's class
browser generator can be used. Doxytag only <em>reads</em> the HTML files, browser generator can be used. Doxytag only <em>reads</em> the HTML files,
they are not altered in any way. they are not altered in any way.
Doxytag expects a list of all HTML files that form the documentation Doxytag expects a list of all HTML files that form the documentation
or a directory that contains all HTML files. If neither is present doxytag or a directory that contains all HTML files. If neither is present doxytag
...@@ -106,13 +94,4 @@ doxytag -t example.tag example/html ...@@ -106,13 +94,4 @@ doxytag -t example.tag example/html
doxytag -t qt.tag $QTDIR/doc/html doxytag -t qt.tag $QTDIR/doc/html
\endverbatim \endverbatim
A typical example to use doxytag to generate a search index is:
\verbatim
doxytag -s search.idx
\endverbatim
\par Note:
In the current version of doxygen, the search index must be
called \c search.idx.
*/ */
...@@ -84,7 +84,6 @@ The second part forms a reference manual: ...@@ -84,7 +84,6 @@ The second part forms a reference manual:
of doxygen and what still has to be done. of doxygen and what still has to be done.
<li>Section \ref doxygen_usage shows how to use the \c doxygen program. <li>Section \ref doxygen_usage shows how to use the \c doxygen program.
<li>Section \ref doxytag_usage shows how to use the \c doxytag program. <li>Section \ref doxytag_usage shows how to use the \c doxytag program.
<li>Section \ref doxysearch_usage shows how to use the \c doxysearch program.
<li>Section \ref doxywizard_usage shows how to use the \c doxywizard program. <li>Section \ref doxywizard_usage shows how to use the \c doxywizard program.
<li>Section \ref installdox_usage shows how to use the \c installdox <li>Section \ref installdox_usage shows how to use the \c installdox
script that is generated by doxygen if you use tag files. script that is generated by doxygen if you use tag files.
......
%!PS-Adobe-2.0 EPSF-2.0 %!PS-Adobe-2.0 EPSF-2.0
%%Title: infoflow.eps %%Title: infoflow.eps
%%Creator: fig2dev Version 3.2 Patchlevel 3c %%Creator: fig2dev Version 3.2 Patchlevel 3c
%%CreationDate: Tue Dec 31 19:32:56 2002 %%CreationDate: Fri Aug 8 17:06:41 2003
%%For: dimitri@pandora.home.nl (Dimitri van Heesch) %%For: dimitri@pandora.home.nl (Dimitri van Heesch)
%%BoundingBox: 0 0 673 585 %%BoundingBox: 0 0 659 583
%%Magnification: 1.0000 %%Magnification: 1.0000
%%EndComments %%EndComments
/$F2psDict 200 dict def /$F2psDict 200 dict def
...@@ -47,8 +47,8 @@ $F2psDict /mtrx matrix put ...@@ -47,8 +47,8 @@ $F2psDict /mtrx matrix put
end end
save save
newpath 0 585 moveto 0 0 lineto 673 0 lineto 673 585 lineto closepath clip newpath newpath 0 583 moveto 0 0 lineto 659 0 lineto 659 583 lineto closepath clip newpath
-39.0 602.0 translate -53.0 600.0 translate
1 -1 scale 1 -1 scale
/cp {closepath} bind def /cp {closepath} bind def
...@@ -142,16 +142,6 @@ gs 1 -1 sc (Config file) col0 sh gr ...@@ -142,16 +142,6 @@ gs 1 -1 sc (Config file) col0 sh gr
3900 2550 m 3900 2550 m
gs 1 -1 sc (Doxyfile) col0 sh gr gs 1 -1 sc (Doxyfile) col0 sh gr
% Polyline % Polyline
n 900 7500 m 1200 7200 l 2100 7200 l 2100 8700 l 900 8700 l 900 7500 l
1200 7500 l
1200 7200 l gs col0 s gr
/Times-Roman-iso ff 180.00 scf sf
1200 7950 m
gs 1 -1 sc (search) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf
1200 8175 m
gs 1 -1 sc (index) col0 sh gr
% Polyline
n 900 3675 m 1200 3375 l 2100 3375 l 2100 4875 l 900 4875 l 900 3675 l n 900 3675 m 1200 3375 l 2100 3375 l 2100 4875 l 900 4875 l 900 3675 l
1200 3675 l 1200 3675 l
1200 3375 l gs col0 s gr 1200 3375 l gs col0 s gr
...@@ -469,15 +459,6 @@ n 10875 9150 m ...@@ -469,15 +459,6 @@ n 10875 9150 m
% arrowhead % arrowhead
n 11264 9180 m 11384 9150 l 11264 9120 l 11264 9180 l cp gs 0.00 setgray ef gr col0 s n 11264 9180 m 11384 9150 l 11264 9120 l 11264 9180 l cp gs 0.00 setgray ef gr col0 s
% Polyline % Polyline
gs clippath
4455 7110 m 4395 7110 l 4395 7261 l 4425 7141 l 4455 7261 l cp
eoclip
n 4425 8850 m
4425 7125 l gs col0 s gr gr
% arrowhead
n 4455 7261 m 4425 7141 l 4395 7261 l 4455 7261 l cp gs 0.00 setgray ef gr col0 s
% Polyline
n 3300 8850 m 5100 8850 l 5100 9525 l 3300 9525 l n 3300 8850 m 5100 8850 l 5100 9525 l 3300 9525 l
cp gs col32 1.00 shd ef gr gs col0 s gr cp gs col32 1.00 shd ef gr gs col0 s gr
% Polyline % Polyline
...@@ -490,42 +471,18 @@ n 6675 9300 m ...@@ -490,42 +471,18 @@ n 6675 9300 m
% arrowhead % arrowhead
n 5236 9270 m 5116 9300 l 5236 9330 l 5236 9270 l cp gs 0.00 setgray ef gr col0 s n 5236 9270 m 5116 9300 l 5236 9330 l 5236 9270 l cp gs 0.00 setgray ef gr col0 s
% Polyline % Polyline
n 675 9300 m 2475 9300 l 2475 9975 l 675 9975 l [60] 0 sd
cp gs col32 1.00 shd ef gr gs col0 s gr n 8700 6450 m 11850 6450 l 11850 9975 l 8700 9975 l
% Polyline cp gs col0 s gr [] 0 sd
gs clippath
2085 7995 m 2085 8055 l 2236 8055 l 2116 8025 l 2236 7995 l cp
eoclip
n 3900 8850 m 3900 8025 l
2100 8025 l gs col0 s gr gr
% arrowhead
n 2236 7995 m 2116 8025 l 2236 8055 l 2236 7995 l cp gs 0.00 setgray ef gr col0 s
% Polyline
gs clippath
1470 9315 m 1530 9315 l 1530 9164 l 1500 9284 l 1470 9164 l cp
eoclip
n 1500 8700 m
1500 9300 l gs col0 s gr gr
% arrowhead
n 1470 9164 m 1500 9284 l 1530 9164 l 1470 9164 l cp gs 0.00 setgray ef gr col0 s
% Polyline % Polyline
gs clippath gs clippath
6690 9780 m 6690 9720 l 6539 9720 l 6659 9750 l 6539 9780 l cp 4305 7110 m 4245 7110 l 4245 7261 l 4275 7141 l 4305 7261 l cp
2460 9720 m 2460 9780 l 2611 9780 l 2491 9750 l 2611 9720 l cp
eoclip eoclip
n 2475 9750 m n 4275 8850 m
6675 9750 l gs col0 s gr gr 4275 7125 l gs col0 s gr gr
% arrowhead % arrowhead
n 2611 9720 m 2491 9750 l 2611 9780 l 2611 9720 l cp gs 0.00 setgray ef gr col0 s n 4305 7261 m 4275 7141 l 4245 7261 l 4305 7261 l cp gs 0.00 setgray ef gr col0 s
% arrowhead
n 6539 9780 m 6659 9750 l 6539 9720 l 6539 9780 l cp gs 0.00 setgray ef gr col0 s
% Polyline
[60] 0 sd
n 8700 6450 m 11850 6450 l 11850 9975 l 8700 9975 l
cp gs col0 s gr [] 0 sd
/Times-Roman-iso ff 180.00 scf sf /Times-Roman-iso ff 180.00 scf sf
4500 3525 m 4500 3525 m
gs 1 -1 sc (generate/update) col0 sh gr gs 1 -1 sc (generate/update) col0 sh gr
...@@ -626,33 +583,15 @@ gs 1 -1 sc (Man pages) col0 sh gr ...@@ -626,33 +583,15 @@ gs 1 -1 sc (Man pages) col0 sh gr
5475 9525 m 5475 9525 m
gs 1 -1 sc (parse) col0 sh gr gs 1 -1 sc (parse) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf /Times-Roman-iso ff 180.00 scf sf
4575 8100 m
gs 1 -1 sc (generate) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf
3825 9300 m 3825 9300 m
gs 1 -1 sc (Doxytag) col0 sh gr gs 1 -1 sc (Doxytag) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf /Times-Roman-iso ff 180.00 scf sf
1050 9750 m
gs 1 -1 sc (Doxysearch) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf
1575 9075 m
gs 1 -1 sc (uses) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf
2700 9975 m
gs 1 -1 sc (used from) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf
5700 9975 m
gs 1 -1 sc (generates) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf
8325 9075 m 8325 9075 m
gs 1 -1 sc (read) col0 sh gr gs 1 -1 sc (read) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf /Times-Roman-iso ff 180.00 scf sf
8775 6675 m 8775 6675 m
gs 1 -1 sc (Windows only) col0 sh gr gs 1 -1 sc (Windows only) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf /Times-Roman-iso ff 180.00 scf sf
2700 8250 m
gs 1 -1 sc (generate) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf
8250 1200 m 8250 1200 m
gs 1 -1 sc (read) col0 sh gr gs 1 -1 sc (read) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf /Times-Roman-iso ff 180.00 scf sf
...@@ -661,5 +600,8 @@ gs 1 -1 sc (Sources) col0 sh gr ...@@ -661,5 +600,8 @@ gs 1 -1 sc (Sources) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf /Times-Roman-iso ff 180.00 scf sf
1275 5775 m 1275 5775 m
gs 1 -1 sc (Custom) col0 sh gr gs 1 -1 sc (Custom) col0 sh gr
/Times-Roman-iso ff 180.00 scf sf
4350 8175 m
gs 1 -1 sc (generate) col0 sh gr
$F2psEnd $F2psEnd
rs rs
...@@ -16,13 +16,6 @@ Single ...@@ -16,13 +16,6 @@ Single
4 0 0 50 0 0 12 0.0000 4 180 780 3900 2250 Config file\001 4 0 0 50 0 0 12 0.0000 4 180 780 3900 2250 Config file\001
4 0 0 50 0 0 12 0.0000 4 180 645 3900 2550 Doxyfile\001 4 0 0 50 0 0 12 0.0000 4 180 645 3900 2550 Doxyfile\001
-6 -6
6 900 7200 2100 8700
2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 8
900 7500 1200 7200 2100 7200 2100 8700 900 8700 900 7500
1200 7500 1200 7200
4 0 0 50 0 0 12 0.0000 4 135 510 1200 7950 search\001
4 0 0 50 0 0 12 0.0000 4 135 405 1200 8175 index\001
-6
6 900 3150 2325 4875 6 900 3150 2325 4875
2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 8 2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 8
900 3675 1200 3375 2100 3375 2100 4875 900 4875 900 3675 900 3675 1200 3375 2100 3375 2100 4875 900 4875 900 3675
...@@ -181,28 +174,16 @@ Single ...@@ -181,28 +174,16 @@ Single
2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
1 1 1.00 60.00 120.00 1 1 1.00 60.00 120.00
10875 9150 11400 9150 10875 9150 11400 9150
2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
1 1 1.00 60.00 120.00
4425 8850 4425 7125
2 2 0 1 0 32 50 0 20 0.000 0 0 -1 0 0 5 2 2 0 1 0 32 50 0 20 0.000 0 0 -1 0 0 5
3300 8850 5100 8850 5100 9525 3300 9525 3300 8850 3300 8850 5100 8850 5100 9525 3300 9525 3300 8850
2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2 2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
1 1 1.00 60.00 120.00 1 1 1.00 60.00 120.00
6675 9300 5100 9300 6675 9300 5100 9300
2 2 0 1 0 32 50 0 20 0.000 0 0 -1 0 0 5
675 9300 2475 9300 2475 9975 675 9975 675 9300
2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
1 1 1.00 60.00 120.00
3900 8850 3900 8025 2100 8025
2 1 0 1 0 7 50 0 -1 4.000 0 0 -1 1 0 2
1 1 1.00 60.00 120.00
1500 8700 1500 9300
2 1 0 1 0 7 50 0 -1 4.000 0 0 -1 1 1 2
1 1 1.00 60.00 120.00
1 1 1.00 60.00 120.00
2475 9750 6675 9750
2 2 1 1 0 7 50 0 -1 4.000 0 0 -1 0 0 5 2 2 1 1 0 7 50 0 -1 4.000 0 0 -1 0 0 5
8700 6450 11850 6450 11850 9975 8700 9975 8700 6450 8700 6450 11850 6450 11850 9975 8700 9975 8700 6450
2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
1 1 1.00 60.00 120.00
4275 8850 4275 7125
4 0 0 50 0 0 12 0.0000 4 180 1215 4500 3525 generate/update\001 4 0 0 50 0 0 12 0.0000 4 180 1215 4500 3525 generate/update\001
4 0 0 50 0 0 12 0.0000 4 135 330 3600 3525 read\001 4 0 0 50 0 0 12 0.0000 4 135 330 3600 3525 read\001
4 0 0 50 0 0 12 0.0000 4 135 330 2850 3975 read\001 4 0 0 50 0 0 12 0.0000 4 135 330 2850 3975 read\001
...@@ -236,15 +217,10 @@ Single ...@@ -236,15 +217,10 @@ Single
4 0 0 50 0 0 12 0.0000 4 135 315 11100 9000 chm\001 4 0 0 50 0 0 12 0.0000 4 135 315 11100 9000 chm\001
4 0 0 50 0 0 12 0.0000 4 180 840 6825 5625 Man pages\001 4 0 0 50 0 0 12 0.0000 4 180 840 6825 5625 Man pages\001
4 0 0 50 0 0 12 0.0000 4 135 420 5475 9525 parse\001 4 0 0 50 0 0 12 0.0000 4 135 420 5475 9525 parse\001
4 0 0 50 0 0 12 0.0000 4 150 660 4575 8100 generate\001
4 0 0 50 0 0 12 0.0000 4 180 645 3825 9300 Doxytag\001 4 0 0 50 0 0 12 0.0000 4 180 645 3825 9300 Doxytag\001
4 0 0 50 0 0 12 0.0000 4 180 915 1050 9750 Doxysearch\001
4 0 0 50 0 0 12 0.0000 4 90 360 1575 9075 uses\001
4 0 0 50 0 0 12 0.0000 4 135 750 2700 9975 used from\001
4 0 0 50 0 0 12 0.0000 4 150 750 5700 9975 generates\001
4 0 0 50 0 0 12 0.0000 4 135 330 8325 9075 read\001 4 0 0 50 0 0 12 0.0000 4 135 330 8325 9075 read\001
4 0 0 50 0 0 12 0.0000 4 180 1080 8775 6675 Windows only\001 4 0 0 50 0 0 12 0.0000 4 180 1080 8775 6675 Windows only\001
4 0 0 50 0 0 12 0.0000 4 150 660 2700 8250 generate\001
4 0 0 50 0 0 12 0.0000 4 135 330 8250 1200 read\001 4 0 0 50 0 0 12 0.0000 4 135 330 8250 1200 read\001
4 0 0 50 0 0 12 0.0000 4 135 615 1200 4200 Sources\001 4 0 0 50 0 0 12 0.0000 4 135 615 1200 4200 Sources\001
4 0 0 50 0 0 12 0.0000 4 135 585 1275 5775 Custom\001 4 0 0 50 0 0 12 0.0000 4 135 585 1275 5775 Custom\001
4 0 0 50 0 0 12 0.0000 4 150 660 4350 8175 generate\001
doc/infoflow.gif

12.9 KB | W: | H:

doc/infoflow.gif

12.2 KB | W: | H:

doc/infoflow.gif
doc/infoflow.gif
doc/infoflow.gif
doc/infoflow.gif
  • 2-up
  • Swipe
  • Onion skin
...@@ -368,6 +368,18 @@ graphviz (\>=1.8.8). The effect of this incompatibility is that ...@@ -368,6 +368,18 @@ graphviz (\>=1.8.8). The effect of this incompatibility is that
generated graphs in HTML are not properly clickable. For doxygen 1.3 generated graphs in HTML are not properly clickable. For doxygen 1.3
it is recommended to use at least graphviz 1.8.10 or higher. it is recommended to use at least graphviz 1.8.10 or higher.
<b>Red Hat 9.0 problems</b>
If you get the following error after running make
\verbatim
tmake error: qtools.pro:70: Syntax error
\endverbatim
then first type
\verbatim
export LANG=
\endverbatim
before running make.
\section install_src_windows Compiling from source on Windows \section install_src_windows Compiling from source on Windows
Currently, I have only compiled doxygen for Windows using Microsoft's Currently, I have only compiled doxygen for Windows using Microsoft's
......
/****************************************************************************** /******************************************************************************
* <notice>This is the template for generating language.doc. * Warning: this file was generated from the language.tpl template
* Edit manually this file, not the language.doc!</notice> * and the maintainers.txt files by the translator.pl script.
*
* Do not edit this file. Edit the above mentioned files!
* *
* *
* Copyright (C) 1997-2002 by Dimitri van Heesch. * Copyright (C) 1997-2002 by Dimitri van Heesch.
...@@ -23,7 +25,7 @@ Doxygen has built-in support for multiple languages. This means ...@@ -23,7 +25,7 @@ Doxygen has built-in support for multiple languages. This means
that the text fragments that doxygen generates can be produced in that the text fragments that doxygen generates can be produced in
languages other than English (the default) at configuration time. languages other than English (the default) at configuration time.
Currently (version unknown), 28 languages Currently (version 1.3.3), 28 languages
are supported (sorted alphabetically): are supported (sorted alphabetically):
Brazilian Portuguese, Catalan, Chinese, Chinese Traditional, Croatian, Brazilian Portuguese, Catalan, Chinese, Chinese Traditional, Croatian,
Czech, Danish, Dutch, English, Finnish, Czech, Danish, Dutch, English, Finnish,
...@@ -37,7 +39,261 @@ It is sorted by language alphabetically. The <b>Status</b> column ...@@ -37,7 +39,261 @@ It is sorted by language alphabetically. The <b>Status</b> column
was generated from sources and shows approximately the last version was generated from sources and shows approximately the last version
when the translator was updated. when the translator was updated.
$information_table \htmlonly
<TABLE ALIGN=center CELLSPACING=0 CELLPADDING=0 BORDER=0>
<TR BGCOLOR="#000000">
<TD>
<TABLE CELLSPACING=1 CELLPADDING=2 BORDER=0>
<TR BGCOLOR="#4040c0">
<TD ><b><font size=+1 color="#ffffff"> Language </font></b></TD>
<TD ><b><font size=+1 color="#ffffff"> Maintainer </font></b></TD>
<TD ><b><font size=+1 color="#ffffff"> Contact address </font>
<font size=-2 color="#ffffff">(remove the NOSPAM.)</font></b></TD>
<TD ><b><font size=+1 color="#ffffff"> Status </font></b></TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Brazilian Portuguese</TD>
<TD>Fabio "FJTC" Jun Takada Chino</TD>
<TD>chino@NOSPAM.icmc.sc.usp.br</TD>
<TD>1.3.3</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Catalan</TD>
<TD>Albert Mora</TD>
<TD>amora@NOSPAM.iua.upf.es</TD>
<TD>1.2.17</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Chinese</TD>
<TD>Wei Liu<br>Wang Weihan</TD>
<TD>liuwei@NOSPAM.asiainfo.com<br>wangweihan@NOSPAM.capinfo.com.cn</TD>
<TD>1.2.13</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Chinese Traditional</TD>
<TD>Daniel YC Lin<br>Gary Lee</TD>
<TD>daniel@NOSPAM.twpda.com<br>garylee@NOSPAM.ecosine.com.tw</TD>
<TD>1.3.3</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Croatian</TD>
<TD>Boris Bralo</TD>
<TD>boris.bralo@NOSPAM.zg.tel.hr</TD>
<TD>1.3.1</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Czech</TD>
<TD>Petr P&#x0159;ikryl</TD>
<TD>prikrylp@NOSPAM.skil.cz</TD>
<TD>1.3.3</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Danish</TD>
<TD>Erik S&oslash;e S&oslash;rensen</TD>
<TD>erik@NOSPAM.mail.nu</TD>
<TD>strange</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Dutch</TD>
<TD>Dimitri van Heesch</TD>
<TD>dimitri@NOSPAM.stack.nl</TD>
<TD>up-to-date</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>English</TD>
<TD>Dimitri van Heesch</TD>
<TD>dimitri@NOSPAM.stack.nl</TD>
<TD>up-to-date</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Finnish</TD>
<TD>Olli Korhonen</TD>
<TD>Olli.Korhonen@NOSPAM.ccc.fi</TD>
<TD>obsolete</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>French</TD>
<TD>Xavier Outhier</TD>
<TD>xouthier@NOSPAM.yahoo.fr</TD>
<TD>1.3.3</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>German</TD>
<TD>Jens Seidel</TD>
<TD>jensseidel@NOSPAM.users.sf.net</TD>
<TD>1.3.1</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Greek</TD>
<TD>Harry Kalogirou</TD>
<TD>harkal@NOSPAM.rainbow.cs.unipi.gr</TD>
<TD>1.2.11</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Hungarian</TD>
<TD>F&ouml;ldv&aacute;ri Gy&ouml;rgy</TD>
<TD>foldvari@NOSPAM.diatronltd.com</TD>
<TD>1.2.1</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Italian</TD>
<TD>Alessandro Falappa<br>Ahmed Aldo Faisal</TD>
<TD>alessandro@NOSPAM.falappa.net<br>aaf23@NOSPAM.cam.ac.uk</TD>
<TD>1.3.3</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Japanese</TD>
<TD>Ryunosuke Satoh<br>Kenji Nagamatsu</TD>
<TD>sun594@NOSPAM.hotmail.com<br>naga@NOSPAM.joyful.club.ne.jp</TD>
<TD>obsolete</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Korean</TD>
<TD>Richard Kim</TD>
<TD>ryk@NOSPAM.dspwiz.com</TD>
<TD>strange</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Norwegian</TD>
<TD>Lars Erik Jordet</TD>
<TD>lej@NOSPAM.circuitry.no</TD>
<TD>1.2.2</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Polish</TD>
<TD>Piotr Kaminski<br>Grzegorz Kowal</TD>
<TD>Piotr.Kaminski@NOSPAM.ctm.gdynia.pl<br>g_kowal@NOSPAM.poczta.onet.pl</TD>
<TD>strange</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Portuguese</TD>
<TD>Rui Godinho Lopes</TD>
<TD>ruiglopes@NOSPAM.yahoo.com</TD>
<TD>1.3.3</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Romanian</TD>
<TD>Alexandru Iosup</TD>
<TD>aiosup@NOSPAM.yahoo.com</TD>
<TD>1.2.16</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Russian</TD>
<TD>Alexandr Chelpanov</TD>
<TD>cav@NOSPAM.cryptopro.ru</TD>
<TD>strange</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Serbian</TD>
<TD>Dejan Milosavljevic</TD>
<TD>dmilos@NOSPAM.email.com</TD>
<TD>1.3.3</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Slovak</TD>
<TD>Stanislav Kudl&aacute;&#x010d;</TD>
<TD>skudlac@NOSPAM.pobox.sk</TD>
<TD>1.2.18</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Slovene</TD>
<TD>Matjaz Ostroversnik</TD>
<TD>matjaz.ostroversnik@NOSPAM.zrs-tk.si</TD>
<TD>1.2.16</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Spanish</TD>
<TD>Francisco Oltra Thennet</TD>
<TD>foltra@NOSPAM.puc.cl</TD>
<TD>1.2.7</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Swedish</TD>
<TD>XeT Erixon</TD>
<TD>xet@NOSPAM.hem.passagen.se</TD>
<TD>1.3.3</TD>
</TR>
<TR BGCOLOR="#ffffff">
<TD>Ukrainian</TD>
<TD>Olexij Tkatchenko</TD>
<TD>olexij.tkatchenko@NOSPAM.gmx.de</TD>
<TD>1.2.11</TD>
</TR>
</TABLE>
</TD>
</TR>
</TABLE>
\endhtmlonly
\latexonly
\begin{tabular}{|l|l|l|l|}
\hline
{\bf Language} & {\bf Maintainer} & {\bf Contact address} & {\bf Status} \\
\hline
\hline
Brazilian Portuguese & Fabio "FJTC" Jun Takada Chino & {\tt chino@icmc.sc.usp.br} & 1.3.3 \\
\hline
Catalan & Albert Mora & {\tt amora@iua.upf.es} & 1.2.17 \\
\hline
Chinese & Wei Liu & {\tt liuwei@asiainfo.com} & 1.2.13 \\
& Wang Weihan & {\tt wangweihan@capinfo.com.cn} & \\
\hline
Chinese Traditional & Daniel YC Lin & {\tt daniel@twpda.com} & 1.3.3 \\
& Gary Lee & {\tt garylee@ecosine.com.tw} & \\
\hline
Croatian & Boris Bralo & {\tt boris.bralo@zg.tel.hr} & 1.3.1 \\
\hline
Czech & Petr P\v{r}ikryl & {\tt prikrylp@skil.cz} & 1.3.3 \\
\hline
Danish & Erik S\o{}e S\o{}rensen & {\tt erik@mail.nu} & strange \\
\hline
Dutch & Dimitri van Heesch & {\tt dimitri@stack.nl} & up-to-date \\
\hline
English & Dimitri van Heesch & {\tt dimitri@stack.nl} & up-to-date \\
\hline
Finnish & Olli Korhonen & {\tt Olli.Korhonen@ccc.fi} & obsolete \\
\hline
French & Xavier Outhier & {\tt xouthier@yahoo.fr} & 1.3.3 \\
\hline
German & Jens Seidel & {\tt jensseidel@users.sf.net} & 1.3.1 \\
\hline
Greek & Harry Kalogirou & {\tt harkal@rainbow.cs.unipi.gr} & 1.2.11 \\
\hline
Hungarian & F\"{o}ldv\'{a}ri Gy\"{o}rgy & {\tt foldvari@diatronltd.com} & 1.2.1 \\
\hline
Italian & Alessandro Falappa & {\tt alessandro@falappa.net} & 1.3.3 \\
& Ahmed Aldo Faisal & {\tt aaf23@cam.ac.uk} & \\
\hline
Japanese & Ryunosuke Satoh & {\tt sun594@hotmail.com} & obsolete \\
& Kenji Nagamatsu & {\tt naga@joyful.club.ne.jp} & \\
\hline
Korean & Richard Kim & {\tt ryk@dspwiz.com} & strange \\
\hline
Norwegian & Lars Erik Jordet & {\tt lej@circuitry.no} & 1.2.2 \\
\hline
Polish & Piotr Kaminski & {\tt Piotr.Kaminski@ctm.gdynia.pl} & strange \\
& Grzegorz Kowal & {\tt g\_kowal@poczta.onet.pl} & \\
\hline
Portuguese & Rui Godinho Lopes & {\tt ruiglopes@yahoo.com} & 1.3.3 \\
\hline
Romanian & Alexandru Iosup & {\tt aiosup@yahoo.com} & 1.2.16 \\
\hline
Russian & Alexandr Chelpanov & {\tt cav@cryptopro.ru} & strange \\
\hline
Serbian & Dejan Milosavljevic & {\tt dmilos@email.com} & 1.3.3 \\
\hline
Slovak & Stanislav Kudl\'{a}\v{c} & {\tt skudlac@pobox.sk} & 1.2.18 \\
\hline
Slovene & Matjaz Ostroversnik & {\tt matjaz.ostroversnik@zrs-tk.si} & 1.2.16 \\
\hline
Spanish & Francisco Oltra Thennet & {\tt foltra@puc.cl} & 1.2.7 \\
\hline
Swedish & XeT Erixon & {\tt xet@hem.passagen.se} & 1.3.3 \\
\hline
Ukrainian & Olexij Tkatchenko & {\tt olexij.tkatchenko@gmx.de} & 1.2.11 \\
\hline
\end{tabular}
\endlatexonly
Most people on the list have indicated that they were also busy Most people on the list have indicated that they were also busy
doing other things, so if you want to help to speed things up please doing other things, so if you want to help to speed things up please
...@@ -258,9 +514,10 @@ script was developed (located in \c doxygen/doc directory). ...@@ -258,9 +514,10 @@ script was developed (located in \c doxygen/doc directory).
It extracts the important information about obsolete and It extracts the important information about obsolete and
new methods from the source files for each of the languages. new methods from the source files for each of the languages.
The information is stored in the <em>translator report</em> ASCII file The information is stored in the <em>translator report</em> ASCII file
($translator_report_file_name). \htmlonly If you compiled this documentation (<code>doxygen/doc/translator_report.txt</code>). \htmlonly If you compiled this documentation
from sources and if you have also doxygen sources available the from sources and if you have also doxygen sources available the
link $translator_report_link should be valid.\endhtmlonly link <a href="../doc/translator_report.txt">
<code>doxygen/doc/translator_report.txt</code></a> should be valid.\endhtmlonly
Looking at the base class of the language translator, the script Looking at the base class of the language translator, the script
guesses also the status of the translator -- see the last column of guesses also the status of the translator -- see the last column of
......
...@@ -22,15 +22,12 @@ detailed usage information. ...@@ -22,15 +22,12 @@ detailed usage information.
The executable \c doxytag is only needed if you want to generate references The executable \c doxytag is only needed if you want to generate references
to external documentation (i.e. documentation that was generated by doxygen) to external documentation (i.e. documentation that was generated by doxygen)
for which you do not have the sources or to create a search index for for which you do not have the sources. See section \ref doxytag_usage
the search engine. See section \ref doxytag_usage for more detailed usage for more detailed usage information.
information.
The executable \c doxysearch is only needed if you want to use the search Optionally, the executable \c doxywizard can be used, which is a
engine. See section \ref doxysearch_usage for more detailed usage information. graphical front-end for editing the configuration file that is used by
doxygen.
Optionally, the executable \c doxywizard is a graphical front-end for editing
the configuration files that are used by doxygen.
The following figure shows the relation between the tools and the flow The following figure shows the relation between the tools and the flow
of information between them: of information between them:
...@@ -46,8 +43,8 @@ of a single source file, but can also be an entire source tree that is ...@@ -46,8 +43,8 @@ of a single source file, but can also be an entire source tree that is
recursively scanned. recursively scanned.
To simplify the creation of a configuration file, doxygen can create a To simplify the creation of a configuration file, doxygen can create a
template configuration file for you. To do this call \c doxygen with the \c -g template configuration file for you. To do this call \c doxygen
option: from the command line with the \c -g option:
\verbatim \verbatim
doxygen -g <config-file> doxygen -g <config-file>
\endverbatim \endverbatim
...@@ -70,7 +67,7 @@ You can probably leave the values of most tags in a generated template ...@@ -70,7 +67,7 @@ You can probably leave the values of most tags in a generated template
configuration file to their default value. See section \ref config for configuration file to their default value. See section \ref config for
more details about the configuration file. more details about the configuration file.
If you do not like to edit the config file with a text editor, you should If you do not wish to edit the config file with a text editor, you should
have a look at \ref doxywizard_usage "doxywizard", which is a GUI have a look at \ref doxywizard_usage "doxywizard", which is a GUI
front-end that can create, read and write doxygen configuration files, front-end that can create, read and write doxygen configuration files,
and allows setting configuration options by entering them via dialogs. and allows setting configuration options by entering them via dialogs.
......
...@@ -18,6 +18,8 @@ ...@@ -18,6 +18,8 @@
<h2>Known problems:</h2> <h2>Known problems:</h2>
<ul> <ul>
<li>If you have problems building doxygen from sources, please
read \ref unix_problems "this section" first.
<li>Doxygen is <em>not</em> a real compiler, it is only a lexical scanner. <li>Doxygen is <em>not</em> a real compiler, it is only a lexical scanner.
This means that it can and will not detect errors in your source code. This means that it can and will not detect errors in your source code.
<li>Since it impossible to test all possible code fragments, it is <li>Since it impossible to test all possible code fragments, it is
...@@ -60,8 +62,8 @@ ...@@ -60,8 +62,8 @@
documentation, because of possible ambiguities or lack of documentation, because of possible ambiguities or lack of
information about the context in which the code fragment is found. information about the context in which the code fragment is found.
<li>It is not possible to insert a non-member function f in a class A <li>It is not possible to insert a non-member function f in a class A
using the \\relates command, if class A already has a member with name f using the \\relates or \\relatesalso command, if class A already
and the same argument list. has a member with name f and the same argument list.
<li>There is only very limited support for member specialization at the <li>There is only very limited support for member specialization at the
moment. It only works if there is a specialized template class as moment. It only works if there is a specialized template class as
well. well.
...@@ -82,7 +84,15 @@ know why. ...@@ -82,7 +84,15 @@ know why.
\anchor bug_reports \anchor bug_reports
<h2>How to report a bug</h2> <h2>How to report a bug</h2>
If you find a bug please send an e-mail to: dimitri@stack.nl. Bugs are tracked in GNOME's <a href="http://bugzilla.gnome.org">bugzilla</a> database.
Before submitting a
<a href="http://bugzilla.gnome.org/enter_bug.cgi?product=doxygen">new bug</a>,
first
<a href="http://bugzilla.gnome.org/buglist.cgi?product=doxygen&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=NEEDINFO&bug_status=REOPENED&bug_status=VERIFIED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&short_desc=&short_desc_type=substring&long_desc=&long_desc_type=substring&bug_file_loc=&bug_file_loc_type=substring&status_whiteboard=&status_whiteboard_type=substring&keywords=&keywords_type=anywords&op_sys_details=&op_sys_details_type=substring&version_details=&version_details_type=substring&cmdtype=doit&namedcmd=gnome-libs+past+20+days&newqueryname=&order=Reuse+same+sort+as+last+time&form_name=query">
check</a> if the same bug has already been submitted by others.
If you believe you have found a new bug,
please <a href="http://bugzilla.gnome.org/enter_bug.cgi?product=doxygen">file it</a>.
If you are unsure whether or not something is a bug, please ask help If you are unsure whether or not something is a bug, please ask help
on the <a href="http://sourceforge.net/mail/?group_id=5971">users mailing list</a> on the <a href="http://sourceforge.net/mail/?group_id=5971">users mailing list</a>
first (subscription is required). first (subscription is required).
...@@ -105,21 +115,22 @@ always try to include the following information in your bug report: ...@@ -105,21 +115,22 @@ always try to include the following information in your bug report:
source code (could potentially compile) and that the problem is really source code (could potentially compile) and that the problem is really
captured by the example (I often get examples that do not trigger the captured by the example (I often get examples that do not trigger the
actual bug!). If you intend to send more than one file please zip or tar actual bug!). If you intend to send more than one file please zip or tar
the files together into a single attachment for easier processing. the files together into a single file for easier processing.
When reporting a new bug you'll get a chance to attach a file to it
immediately \e after opening the bug.
You can (and are encouraged to) add a patch for a bug. If you do so
please use PATCH as a keyword in the bug entry form.
If you have ideas (or even better some code or a patch) If you have ideas how to fix existing bugs and limitations please discuss them on
how to fix existing bugs and limitations please discuss them on the <a href="http://sourceforge.net/mail/?group_id=5971">developers mailing list</a>
the <a href="http://sourceforge.net/mail/?group_id=5971">developers mailing list</a>. (subscription required). Patches can also be sent directly to dimitri@stack.nl if
Patches can also send directly to dimitri@stack.nl. you prefer not to send them via the bug tracker or mailing list.
For patches please use For patches please use
"diff -uN" or include the files you modified. If you send more than "diff -uN" or include the files you modified. If you send more than
one file please tar or zip everything, so I only have to save and download one file please tar or zip everything, so I only have to save and download
one file. one file.
Note that you can also post bug reports via the bug tracker at
sourceforge, but I do not really like this because of its web
interface, which I find rather clumpsy to use.
*/ */
Summary: A documentation system for C/C++. Summary: A documentation system for C/C++.
Name: doxygen Name: doxygen
Version: 1.3.3_20030808 Version: 1.3.3_20030824
Release: 1 Release: 1
Epoch: 1 Epoch: 1
Source0: ftp://ftp.stack.nl/pub/users/dimitri/%{name}-%{version}.src.tar.gz Source0: ftp://ftp.stack.nl/pub/users/dimitri/%{name}-%{version}.src.tar.gz
......
...@@ -891,6 +891,7 @@ void ClassDef::writeDocumentation(OutputList &ol) ...@@ -891,6 +891,7 @@ void ClassDef::writeDocumentation(OutputList &ol)
{ {
ol.startTypewriter(); ol.startTypewriter();
bool isIDLorJava = nm.right(4)==".idl" || bool isIDLorJava = nm.right(4)==".idl" ||
nm.right(5)==".pidl" ||
nm.right(5)==".java"; nm.right(5)==".java";
if (isIDLorJava) if (isIDLorJava)
{ {
......
...@@ -95,7 +95,15 @@ void ClassSDict::writeDeclaration(OutputList &ol,const ClassDef::CompoundType *f ...@@ -95,7 +95,15 @@ void ClassSDict::writeDeclaration(OutputList &ol,const ClassDef::CompoundType *f
} }
ol.startMemberItem(FALSE); ol.startMemberItem(FALSE);
QCString tmp = cd->compoundTypeString(); QCString tmp = cd->compoundTypeString();
QCString cname = substitute(cd->className(),"::","."); QCString cname;
if (Config_getBool("OPTIMIZE_OUTPUT_JAVA"))
{
cname = substitute(cd->className(),"::",".");
}
else
{
cname = cd->className();
}
ol.writeString(tmp); ol.writeString(tmp);
ol.writeString(" "); ol.writeString(" ");
ol.insertMemberAlign(); ol.insertMemberAlign();
......
...@@ -49,7 +49,7 @@ class ClassDict : public QDict<ClassDef> ...@@ -49,7 +49,7 @@ class ClassDict : public QDict<ClassDef>
class ClassSDict : public SDict<ClassDef> class ClassSDict : public SDict<ClassDef>
{ {
public: public:
ClassSDict(int size) : SDict<ClassDef>(size) {} ClassSDict(int size=17) : SDict<ClassDef>(size) {}
~ClassSDict() {} ~ClassSDict() {}
int compareItems(GCI item1,GCI item2); int compareItems(GCI item1,GCI item2);
void writeDeclaration(OutputList &ol,const ClassDef::CompoundType *filter=0, void writeDeclaration(OutputList &ol,const ClassDef::CompoundType *filter=0,
......
...@@ -185,7 +185,7 @@ void VariableContext::addVariable(const QCString &type,const QCString &name) ...@@ -185,7 +185,7 @@ void VariableContext::addVariable(const QCString &type,const QCString &name)
int i=0; int i=0;
if ( if (
(varType=g_codeClassSDict[ltype]) || // look for class definitions inside the code block (varType=g_codeClassSDict[ltype]) || // look for class definitions inside the code block
(varType=getResolvedClass(g_currentDefinition,ltype)) // look for global class definitions (varType=getResolvedClass(g_currentDefinition,g_sourceFileDef,ltype)) // look for global class definitions
) )
{ {
DBG_CTX((stderr,"** AddVariable type=%s name=%s\n",ltype.data(),lname.data())); DBG_CTX((stderr,"** AddVariable type=%s name=%s\n",ltype.data(),lname.data()));
...@@ -507,11 +507,11 @@ static ClassDef *stripClassName(const char *s) ...@@ -507,11 +507,11 @@ static ClassDef *stripClassName(const char *s)
ClassDef *cd=0; ClassDef *cd=0;
if (!g_classScope.isEmpty()) if (!g_classScope.isEmpty())
{ {
cd=getResolvedClass(g_currentDefinition,g_classScope+"::"+clName); cd=getResolvedClass(g_currentDefinition,g_sourceFileDef,g_classScope+"::"+clName);
} }
if (cd==0) if (cd==0)
{ {
cd=getResolvedClass(g_currentDefinition,clName); cd=getResolvedClass(g_currentDefinition,g_sourceFileDef,clName);
} }
//printf("stripClass trying `%s' = %p\n",clName.data(),cd); //printf("stripClass trying `%s' = %p\n",clName.data(),cd);
if (cd) if (cd)
...@@ -651,14 +651,16 @@ static void generateClassOrGlobalLink(BaseCodeDocInterface &ol,char *clName, ...@@ -651,14 +651,16 @@ static void generateClassOrGlobalLink(BaseCodeDocInterface &ol,char *clName,
if (!g_theVarContext.findVariable(className)) // not a local variable if (!g_theVarContext.findVariable(className)) // not a local variable
{ {
//printf("not a local var!\n");
Definition *d = g_currentDefinition; Definition *d = g_currentDefinition;
cd = getResolvedClass(d,className); cd = getResolvedClass(d,g_sourceFileDef,className);
if (cd==0 && (i=className.find('<'))!=-1) if (cd==0 && (i=className.find('<'))!=-1)
{ {
cd=getResolvedClass(d,className.left(i)); cd=getResolvedClass(d,g_sourceFileDef,className.left(i));
} }
} }
else
{
}
if (cd && cd->isLinkable()) // is it a linkable class if (cd && cd->isLinkable()) // is it a linkable class
{ {
//printf("is linkable class %s\n",clName); //printf("is linkable class %s\n",clName);
...@@ -678,12 +680,13 @@ static void generateClassOrGlobalLink(BaseCodeDocInterface &ol,char *clName, ...@@ -678,12 +680,13 @@ static void generateClassOrGlobalLink(BaseCodeDocInterface &ol,char *clName,
} }
else else
{ {
//printf("class %s not linkable! cd=%p\n",clName,cd);
//printf("typeOnly=%d\n",typeOnly); //printf("typeOnly=%d\n",typeOnly);
if (cd==0 && !typeOnly) // not a class, see if it is a global enum/variable/typedef. if (cd==0 && !typeOnly) // not a class, see if it is a global enum/variable/typedef.
{ {
MemberDef *md = setCallContextForVar(clName); MemberDef *md = setCallContextForVar(clName);
//printf("is a global md=%p\n",md); //printf("is a global md=%p g_currentDefinition=%s\n",md,g_currentDefinition?g_currentDefinition->name().data():"<none>");
if (md) if (md && (g_currentDefinition==0 || isAccessibleFrom(g_currentDefinition,g_sourceFileDef,md)!=-1))
{ {
Definition *d = md->getOuterScope()==Doxygen::globalScope ? Definition *d = md->getOuterScope()==Doxygen::globalScope ?
md->getBodyDef() : md->getOuterScope(); md->getBodyDef() : md->getOuterScope();
...@@ -849,7 +852,7 @@ static void generateMemberLink(BaseCodeDocInterface &ol,const QCString &varName, ...@@ -849,7 +852,7 @@ static void generateMemberLink(BaseCodeDocInterface &ol,const QCString &varName,
} }
else // variable not in current context, maybe it is in a parent context else // variable not in current context, maybe it is in a parent context
{ {
vcd = getResolvedClass(g_currentDefinition,g_classScope); vcd = getResolvedClass(g_currentDefinition,g_sourceFileDef,g_classScope);
if (vcd && vcd->isLinkable()) if (vcd && vcd->isLinkable())
{ {
//printf("Found class %s for variable `%s'\n",g_classScope.data(),varName.data()); //printf("Found class %s for variable `%s'\n",g_classScope.data(),varName.data());
...@@ -1166,6 +1169,9 @@ TYPEKW ("bool"|"char"|"double"|"float"|"int"|"long"|"short"|"signed"|"unsigned" ...@@ -1166,6 +1169,9 @@ TYPEKW ("bool"|"char"|"double"|"float"|"int"|"long"|"short"|"signed"|"unsigned"
{ {
g_insideBody=FALSE; g_insideBody=FALSE;
g_currentMemberDef=0; g_currentMemberDef=0;
if (g_currentDefinition)
g_currentDefinition=g_currentDefinition->getOuterScope();
else
g_currentDefinition=0; g_currentDefinition=0;
} }
BEGIN(Body); BEGIN(Body);
...@@ -1232,7 +1238,7 @@ TYPEKW ("bool"|"char"|"double"|"float"|"int"|"long"|"short"|"signed"|"unsigned" ...@@ -1232,7 +1238,7 @@ TYPEKW ("bool"|"char"|"double"|"float"|"int"|"long"|"short"|"signed"|"unsigned"
g_scopeStack.push(CLASSBLOCK); g_scopeStack.push(CLASSBLOCK);
pushScope(g_curClassName); pushScope(g_curClassName);
//printf("***** g_curClassName=%s\n",g_curClassName.data()); //printf("***** g_curClassName=%s\n",g_curClassName.data());
if (getResolvedClass(g_currentDefinition,g_curClassName)==0) if (getResolvedClass(g_currentDefinition,g_sourceFileDef,g_curClassName)==0)
{ {
g_curClassDef=new ClassDef("<code>",1, g_curClassDef=new ClassDef("<code>",1,
g_curClassName,ClassDef::Class); g_curClassName,ClassDef::Class);
...@@ -1243,7 +1249,7 @@ TYPEKW ("bool"|"char"|"double"|"float"|"int"|"long"|"short"|"signed"|"unsigned" ...@@ -1243,7 +1249,7 @@ TYPEKW ("bool"|"char"|"double"|"float"|"int"|"long"|"short"|"signed"|"unsigned"
{ {
ClassDef *bcd; ClassDef *bcd;
bcd=g_codeClassSDict[s]; bcd=g_codeClassSDict[s];
if (bcd==0) bcd=getResolvedClass(g_currentDefinition,s); if (bcd==0) bcd=getResolvedClass(g_currentDefinition,g_sourceFileDef,s);
if (bcd) if (bcd)
{ {
g_curClassDef->insertBaseClass(bcd,s,Public,Normal); g_curClassDef->insertBaseClass(bcd,s,Public,Normal);
...@@ -1631,7 +1637,7 @@ TYPEKW ("bool"|"char"|"double"|"float"|"int"|"long"|"short"|"signed"|"unsigned" ...@@ -1631,7 +1637,7 @@ TYPEKW ("bool"|"char"|"double"|"float"|"int"|"long"|"short"|"signed"|"unsigned"
int index = g_name.findRev("::"); int index = g_name.findRev("::");
if (index!=-1) if (index!=-1)
{ {
ClassDef *cd=getResolvedClass(Doxygen::globalScope,g_name.left(index)); ClassDef *cd=getResolvedClass(Doxygen::globalScope,g_sourceFileDef,g_name.left(index));
if (cd) if (cd)
{ {
setClassScope(cd->name()); setClassScope(cd->name());
......
...@@ -497,6 +497,7 @@ class Config ...@@ -497,6 +497,7 @@ class Config
{ {
ConfigObsolete *option = new ConfigObsolete(ConfigOption::O_Obsolete); ConfigObsolete *option = new ConfigObsolete(ConfigOption::O_Obsolete);
m_dict->insert(name,option); m_dict->insert(name,option);
m_obsolete->append(option);
return option; return option;
} }
/*! @} */ /*! @} */
...@@ -539,23 +540,29 @@ class Config ...@@ -539,23 +540,29 @@ class Config
* to the configuration object * to the configuration object
*/ */
void create(); void create();
protected: protected:
Config() Config()
{ {
m_options = new QList<ConfigOption>; m_options = new QList<ConfigOption>;
m_obsolete = new QList<ConfigOption>;
m_dict = new QDict<ConfigOption>(257); m_dict = new QDict<ConfigOption>(257);
m_options->setAutoDelete(TRUE); m_options->setAutoDelete(TRUE);
m_obsolete->setAutoDelete(TRUE);
m_initialized = FALSE; m_initialized = FALSE;
create(); create();
} }
~Config() ~Config()
{ {
delete m_options; delete m_options;
delete m_obsolete;
delete m_dict; delete m_dict;
} }
private: private:
QList<ConfigOption> *m_options; QList<ConfigOption> *m_options;
QList<ConfigOption> *m_obsolete;
QDict<ConfigOption> *m_dict; QDict<ConfigOption> *m_dict;
static Config *m_instance; static Config *m_instance;
bool m_initialized; bool m_initialized;
......
...@@ -1270,7 +1270,7 @@ void Config::create() ...@@ -1270,7 +1270,7 @@ void Config::create()
// option definitions // option definitions
//----------------------------------------------------------------------------------------------- //-----------------------------------------------------------------------------------------------
addInfo("General","General configuration options"); addInfo("Project","Project related configuration options");
//----------------------------------------------------------------------------------------------- //-----------------------------------------------------------------------------------------------
...@@ -1403,6 +1403,143 @@ void Config::create() ...@@ -1403,6 +1403,143 @@ void Config::create()
FALSE FALSE
#endif #endif
); );
cb = addBool(
"BRIEF_MEMBER_DESC",
"If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will \n"
"include brief member descriptions after the members that are listed in \n"
"the file and class documentation (similar to JavaDoc). \n"
"Set to NO to disable this. \n",
TRUE
);
cb = addBool(
"REPEAT_BRIEF",
"If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend \n"
"the brief description of a member or function before the detailed description. \n"
"Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the \n"
"brief descriptions will be completely suppressed. \n",
TRUE
);
cb = addBool(
"ALWAYS_DETAILED_SEC",
"If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then \n"
"Doxygen will generate a detailed section even if there is only a brief \n"
"description. \n",
FALSE
);
cb = addBool(
"INLINE_INHERITED_MEMB",
"If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all inherited \n"
"members of a class in the documentation of that class as if those members were \n"
"ordinary class members. Constructors, destructors and assignment operators of \n"
"the base classes will not be shown. \n",
FALSE
);
cb = addBool(
"FULL_PATH_NAMES",
"If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full \n"
"path before files name in the file list and in the header files. If set \n"
"to NO the shortest path that makes the file name unique will be used. \n",
FALSE
);
cl = addList(
"STRIP_FROM_PATH",
"If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag \n"
"can be used to strip a user-defined part of the path. Stripping is \n"
"only done if one of the specified strings matches the left-hand part of \n"
"the path. It is allowed to use relative paths in the argument list.\n"
);
cl->addDependency("FULL_PATH_NAMES");
cb = addBool(
"SHORT_NAMES",
"If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter \n"
"(but less readable) file names. This can be useful is your file systems \n"
"doesn't support long names like on DOS, Mac, or CD-ROM. \n",
FALSE
);
cb = addBool(
"JAVADOC_AUTOBRIEF",
"If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen \n"
"will interpret the first line (until the first dot) of a JavaDoc-style \n"
"comment as the brief description. If set to NO, the JavaDoc \n"
"comments will behave just like the Qt-style comments (thus requiring an \n"
"explict @brief command for a brief description. \n",
FALSE
);
cb = addBool(
"MULTILINE_CPP_IS_BRIEF",
"The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen \n"
"treat a multi-line C++ special comment block (i.e. a block of //! or /// \n"
"comments) as a brief description. This used to be the default behaviour. \n"
"The new default is to treat a multi-line C++ comment block as a detailed \n"
"description. Set this tag to YES if you prefer the old behaviour instead. \n",
FALSE
);
cb = addBool(
"DETAILS_AT_TOP",
"If the DETAILS_AT_TOP tag is set to YES then Doxygen \n"
"will output the detailed description near the top, like JavaDoc.\n"
"If set to NO, the detailed description appears after the member \n"
"documentation. \n",
FALSE
);
cb = addBool(
"INHERIT_DOCS",
"If the INHERIT_DOCS tag is set to YES (the default) then an undocumented \n"
"member inherits the documentation from any documented member that it \n"
"reimplements. \n",
TRUE
);
cb = addBool(
"DISTRIBUTE_GROUP_DOC",
"If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC \n"
"tag is set to YES, then doxygen will reuse the documentation of the first \n"
"member in the group (if any) for the other members of the group. By default \n"
"all members of a group must be documented explicitly.\n",
FALSE
);
ci = addInt(
"TAB_SIZE",
"The TAB_SIZE tag can be used to set the number of spaces in a tab. \n"
"Doxygen uses this value to replace tabs by spaces in code fragments. \n",
1,16,8
);
cl = addList(
"ALIASES",
"This tag can be used to specify a number of aliases that acts \n"
"as commands in the documentation. An alias has the form \"name=value\". \n"
"For example adding \"sideeffect=\\par Side Effects:\\n\" will allow you to \n"
"put the command \\sideeffect (or @sideeffect) in the documentation, which \n"
"will result in a user-defined paragraph with heading \"Side Effects:\". \n"
"You can put \\n's in the value part of an alias to insert newlines. \n"
);
cb = addBool(
"OPTIMIZE_OUTPUT_FOR_C",
"Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources \n"
"only. Doxygen will then generate output that is more tailored for C. \n"
"For instance, some of the names that are used will be different. The list \n"
"of all members will be omitted, etc. \n",
FALSE
);
cb = addBool(
"OPTIMIZE_OUTPUT_JAVA",
"Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java sources \n"
"only. Doxygen will then generate output that is more tailored for Java. \n"
"For instance, namespaces will be presented as packages, qualified scopes \n"
"will look different, etc. \n",
FALSE
);
cb = addBool(
"SUBGROUPING",
"Set the SUBGROUPING tag to YES (the default) to allow class member groups of \n"
"the same type (for instance a group of public functions) to be put as a \n"
"subgroup of that type (e.g. under the Public Functions section). Set it to \n"
"NO to prevent subgrouping. Alternatively, this can be done per class using \n"
"the \\nosubgrouping command. \n",
TRUE
);
//-----------------------------------------------------------------------------------------------
addInfo("Build","Build related configuration options");
//-----------------------------------------------------------------------------------------------
cb = addBool( cb = addBool(
"EXTRACT_ALL", "EXTRACT_ALL",
"If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in \n" "If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in \n"
...@@ -1463,52 +1600,6 @@ void Config::create() ...@@ -1463,52 +1600,6 @@ void Config::create()
"function's detailed documentation block. \n", "function's detailed documentation block. \n",
FALSE FALSE
); );
cb = addBool(
"BRIEF_MEMBER_DESC",
"If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will \n"
"include brief member descriptions after the members that are listed in \n"
"the file and class documentation (similar to JavaDoc). \n"
"Set to NO to disable this. \n",
TRUE
);
cb = addBool(
"REPEAT_BRIEF",
"If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend \n"
"the brief description of a member or function before the detailed description. \n"
"Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the \n"
"brief descriptions will be completely suppressed. \n",
TRUE
);
cb = addBool(
"ALWAYS_DETAILED_SEC",
"If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then \n"
"Doxygen will generate a detailed section even if there is only a brief \n"
"description. \n",
FALSE
);
cb = addBool(
"INLINE_INHERITED_MEMB",
"If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all inherited \n"
"members of a class in the documentation of that class as if those members were \n"
"ordinary class members. Constructors, destructors and assignment operators of \n"
"the base classes will not be shown. \n",
FALSE
);
cb = addBool(
"FULL_PATH_NAMES",
"If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full \n"
"path before files name in the file list and in the header files. If set \n"
"to NO the shortest path that makes the file name unique will be used. \n",
FALSE
);
cl = addList(
"STRIP_FROM_PATH",
"If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag \n"
"can be used to strip a user-defined part of the path. Stripping is \n"
"only done if one of the specified strings matches the left-hand part of \n"
"the path. It is allowed to use relative paths in the argument list.\n"
);
cl->addDependency("FULL_PATH_NAMES");
cb = addBool( cb = addBool(
"INTERNAL_DOCS", "INTERNAL_DOCS",
"The INTERNAL_DOCS tag determines if documentation \n" "The INTERNAL_DOCS tag determines if documentation \n"
...@@ -1526,13 +1617,6 @@ void Config::create() ...@@ -1526,13 +1617,6 @@ void Config::create()
"users are advised to set this option to NO.\n", "users are advised to set this option to NO.\n",
TRUE TRUE
); );
cb = addBool(
"SHORT_NAMES",
"If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter \n"
"(but less readable) file names. This can be useful is your file systems \n"
"doesn't support long names like on DOS, Mac, or CD-ROM. \n",
FALSE
);
cb = addBool( cb = addBool(
"HIDE_SCOPE_NAMES", "HIDE_SCOPE_NAMES",
"If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen \n" "If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen \n"
...@@ -1547,39 +1631,6 @@ void Config::create() ...@@ -1547,39 +1631,6 @@ void Config::create()
"of that file. \n", "of that file. \n",
TRUE TRUE
); );
cb = addBool(
"JAVADOC_AUTOBRIEF",
"If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen \n"
"will interpret the first line (until the first dot) of a JavaDoc-style \n"
"comment as the brief description. If set to NO, the JavaDoc \n"
"comments will behave just like the Qt-style comments (thus requiring an \n"
"explict @brief command for a brief description. \n",
FALSE
);
cb = addBool(
"MULTILINE_CPP_IS_BRIEF",
"The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen \n"
"treat a multi-line C++ special comment block (i.e. a block of //! or /// \n"
"comments) as a brief description. This used to be the default behaviour. \n"
"The new default is to treat a multi-line C++ comment block as a detailed \n"
"description. Set this tag to YES if you prefer the old behaviour instead. \n",
FALSE
);
cb = addBool(
"DETAILS_AT_TOP",
"If the DETAILS_AT_TOP tag is set to YES then Doxygen \n"
"will output the detailed description near the top, like JavaDoc.\n"
"If set to NO, the detailed description appears after the member \n"
"documentation. \n",
FALSE
);
cb = addBool(
"INHERIT_DOCS",
"If the INHERIT_DOCS tag is set to YES (the default) then an undocumented \n"
"member inherits the documentation from any documented member that it \n"
"reimplements. \n",
TRUE
);
cb = addBool( cb = addBool(
"INLINE_INFO", "INLINE_INFO",
"If the INLINE_INFO tag is set to YES (the default) then a tag [inline] \n" "If the INLINE_INFO tag is set to YES (the default) then a tag [inline] \n"
...@@ -1594,20 +1645,6 @@ void Config::create() ...@@ -1594,20 +1645,6 @@ void Config::create()
"declaration order. \n", "declaration order. \n",
TRUE TRUE
); );
cb = addBool(
"DISTRIBUTE_GROUP_DOC",
"If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC \n"
"tag is set to YES, then doxygen will reuse the documentation of the first \n"
"member in the group (if any) for the other members of the group. By default \n"
"all members of a group must be documented explicitly.\n",
FALSE
);
ci = addInt(
"TAB_SIZE",
"The TAB_SIZE tag can be used to set the number of spaces in a tab. \n"
"Doxygen uses this value to replace tabs by spaces in code fragments. \n",
1,16,8
);
cb = addBool( cb = addBool(
"GENERATE_TODOLIST", "GENERATE_TODOLIST",
"The GENERATE_TODOLIST tag can be used to enable (YES) or \n" "The GENERATE_TODOLIST tag can be used to enable (YES) or \n"
...@@ -1636,15 +1673,6 @@ void Config::create() ...@@ -1636,15 +1673,6 @@ void Config::create()
"\\deprecated commands in the documentation.\n", "\\deprecated commands in the documentation.\n",
TRUE TRUE
); );
cl = addList(
"ALIASES",
"This tag can be used to specify a number of aliases that acts \n"
"as commands in the documentation. An alias has the form \"name=value\". \n"
"For example adding \"sideeffect=\\par Side Effects:\\n\" will allow you to \n"
"put the command \\sideeffect (or @sideeffect) in the documentation, which \n"
"will result in a user-defined paragraph with heading \"Side Effects:\". \n"
"You can put \\n's in the value part of an alias to insert newlines. \n"
);
cl = addList( cl = addList(
"ENABLED_SECTIONS", "ENABLED_SECTIONS",
"The ENABLED_SECTIONS tag can be used to enable conditional \n" "The ENABLED_SECTIONS tag can be used to enable conditional \n"
...@@ -1661,22 +1689,6 @@ void Config::create() ...@@ -1661,22 +1689,6 @@ void Config::create()
"command in the documentation regardless of this setting. \n", "command in the documentation regardless of this setting. \n",
0,10000,30 0,10000,30
); );
cb = addBool(
"OPTIMIZE_OUTPUT_FOR_C",
"Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources \n"
"only. Doxygen will then generate output that is more tailored for C. \n"
"For instance, some of the names that are used will be different. The list \n"
"of all members will be omitted, etc. \n",
FALSE
);
cb = addBool(
"OPTIMIZE_OUTPUT_JAVA",
"Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java sources \n"
"only. Doxygen will then generate output that is more tailored for Java. \n"
"For instance, namespaces will be presented as packages, qualified scopes \n"
"will look different, etc. \n",
FALSE
);
cb = addBool( cb = addBool(
"SHOW_USED_FILES", "SHOW_USED_FILES",
"Set the SHOW_USED_FILES tag to NO to disable the list of files generated \n" "Set the SHOW_USED_FILES tag to NO to disable the list of files generated \n"
...@@ -1684,15 +1696,7 @@ void Config::create() ...@@ -1684,15 +1696,7 @@ void Config::create()
"list will mention the files that were used to generate the documentation. \n", "list will mention the files that were used to generate the documentation. \n",
TRUE TRUE
); );
cb = addBool(
"SUBGROUPING",
"Set the SUBGROUPING tag to YES (the default) to allow class member groups of \n"
"the same type (for instance a group of public functions) to be put as a \n"
"subgroup of that type (e.g. under the Public Functions section). Set it to \n"
"NO to prevent subgrouping. Alternatively, this can be done per class using \n"
"the \\nosubgrouping command. \n",
TRUE
);
//----------------------------------------------------------------------------------------------- //-----------------------------------------------------------------------------------------------
addInfo( "Messages","configuration options related to warning and progress messages"); addInfo( "Messages","configuration options related to warning and progress messages");
//----------------------------------------------------------------------------------------------- //-----------------------------------------------------------------------------------------------
......
...@@ -18,6 +18,8 @@ ...@@ -18,6 +18,8 @@
#include "qtbc.h" #include "qtbc.h"
#include <ctype.h> #include <ctype.h>
#include <qregexp.h> #include <qregexp.h>
#include <stdio.h>
#include <stdlib.h>
#include "config.h" #include "config.h"
#include "definition.h" #include "definition.h"
#include "doxygen.h" #include "doxygen.h"
...@@ -29,6 +31,47 @@ ...@@ -29,6 +31,47 @@
#include "groupdef.h" #include "groupdef.h"
#include "section.h" #include "section.h"
#if defined(_MSC_VER) || defined(__BORLANDC__)
#define popen _popen
#define pclose _pclose
#endif
static void addToMap(const char *name,Definition *d)
{
QCString symbolName = name;
int index=symbolName.findRev("::");
if (index!=-1) symbolName=symbolName.mid(index+2);
if (!symbolName.isEmpty())
{
DefinitionList *dl=Doxygen::symbolMap->find(symbolName);
if (dl==0)
{
dl = new DefinitionList;
Doxygen::symbolMap->append(symbolName,dl);
}
//printf("******* adding symbol `%s'\n",symbolName.data());
dl->append(d);
}
}
static void removeFromMap(Definition *d)
{
QCString symbolName = d->name();
int index=symbolName.findRev("::");
if (index!=-1) symbolName=symbolName.mid(index+2);
if (!symbolName.isEmpty())
{
//printf("******* removing symbol `%s'\n",symbolName.data());
DefinitionList *dl=Doxygen::symbolMap->find(symbolName);
if (dl)
{
ASSERT(dl!=0);
bool b = dl->removeRef(d);
ASSERT(b==TRUE);
}
}
}
Definition::Definition(const char *df,int dl, Definition::Definition(const char *df,int dl,
const char *name,const char *b,const char *d) const char *name,const char *b,const char *d)
{ {
...@@ -64,10 +107,12 @@ Definition::Definition(const char *df,int dl, ...@@ -64,10 +107,12 @@ Definition::Definition(const char *df,int dl,
m_briefFile=(QCString)"<"+name+">"; m_briefFile=(QCString)"<"+name+">";
m_docLine=1; m_docLine=1;
m_docFile=(QCString)"<"+name+">"; m_docFile=(QCString)"<"+name+">";
addToMap(name,this);
} }
Definition::~Definition() Definition::~Definition()
{ {
removeFromMap(this);
delete m_sectionDict; delete m_sectionDict;
delete m_sourceRefByDict; delete m_sourceRefByDict;
delete m_sourceRefsDict; delete m_sourceRefsDict;
...@@ -196,26 +241,27 @@ static bool readCodeFragment(const char *fileName, ...@@ -196,26 +241,27 @@ static bool readCodeFragment(const char *fileName,
{ {
//printf("readCodeFragment(%s,%d,%d)\n",fileName,startLine,endLine); //printf("readCodeFragment(%s,%d,%d)\n",fileName,startLine,endLine);
if (fileName==0 || fileName[0]==0) return FALSE; // not a valid file name if (fileName==0 || fileName[0]==0) return FALSE; // not a valid file name
QFile f(fileName); QCString cmd=Config_getString("INPUT_FILTER")+" \""+fileName+"\"";
if (f.open(IO_ReadOnly)) FILE *f = Config_getBool("FILTER_SOURCE_FILES") ? popen(cmd,"r") : fopen(fileName,"r");
if (f)
{ {
int c=0; int c=0;
int col=0; int col=0;
int lineNr=1; int lineNr=1;
// skip until the startLine has reached // skip until the startLine has reached
while (lineNr<startLine && !f.atEnd()) while (lineNr<startLine && !feof(f))
{ {
while ((c=f.getch())!='\n' && c!=-1) /* skip */; while ((c=fgetc(f))!='\n' && c==EOF) /* skip */;
lineNr++; lineNr++;
} }
if (!f.atEnd()) if (!feof(f))
{ {
// skip until the opening bracket or lonely : is found // skip until the opening bracket or lonely : is found
bool found=FALSE; bool found=FALSE;
char cn=0; char cn=0;
while (lineNr<=endLine && !f.atEnd() && !found) while (lineNr<=endLine && !feof(f) && !found)
{ {
while ((c=f.getch())!='{' && c!=':' && c!=-1) while ((c=fgetc(f))!='{' && c!=':' && c!=EOF)
{ {
if (c=='\n') if (c=='\n')
{ {
...@@ -232,7 +278,7 @@ static bool readCodeFragment(const char *fileName, ...@@ -232,7 +278,7 @@ static bool readCodeFragment(const char *fileName,
} }
if (c==':') if (c==':')
{ {
cn=f.getch(); cn=fgetc(f);
if (cn!=':') found=TRUE; if (cn!=':') found=TRUE;
} }
else if (c=='{') else if (c=='{')
...@@ -262,12 +308,13 @@ static bool readCodeFragment(const char *fileName, ...@@ -262,12 +308,13 @@ static bool readCodeFragment(const char *fileName,
int size_read; int size_read;
do { do {
// read up to maxLineLength-1 bytes, the last byte being zero // read up to maxLineLength-1 bytes, the last byte being zero
size_read = f.readLine(lineStr, maxLineLength); char *p = fgets(lineStr, maxLineLength,f);
if (p) size_read=qstrlen(p); else size_read=-1;
result+=lineStr; result+=lineStr;
} while (size_read == (maxLineLength-1)); } while (size_read == (maxLineLength-1));
lineNr++; lineNr++;
} while (lineNr<=endLine && !f.atEnd()); } while (lineNr<=endLine && !feof(f));
// strip stuff after closing bracket // strip stuff after closing bracket
int newLineIndex = result.findRev('\n'); int newLineIndex = result.findRev('\n');
......
...@@ -572,12 +572,15 @@ static int handleStyleArgument(DocNode *parent,QList<DocNode> &children, ...@@ -572,12 +572,15 @@ static int handleStyleArgument(DocNode *parent,QList<DocNode> &children,
g_token->name.data(),cmdName.data()); g_token->name.data(),cmdName.data());
break; break;
case TK_SYMBOL: case TK_SYMBOL:
warn_doc_error(g_fileName,doctokenizerYYlineno,"Warning: Unsupported symbol %s found", warn_doc_error(g_fileName,doctokenizerYYlineno,"Warning: Unsupported symbol %s found while handling command %s",
g_token->name.data()); g_token->name.data(),cmdName.data());
break;
case TK_HTMLTAG:
return tok;
break; break;
default: default:
warn_doc_error(g_fileName,doctokenizerYYlineno,"Warning: Unexpected token %s", warn_doc_error(g_fileName,doctokenizerYYlineno,"Warning: Unexpected token %s while handling command %s",
tokToString(tok)); tokToString(tok),cmdName.data());
break; break;
} }
break; break;
...@@ -789,7 +792,7 @@ reparsetoken: ...@@ -789,7 +792,7 @@ reparsetoken:
children.append(new DocStyleChange(parent,g_nodeStack.count(),DocStyleChange::Italic,FALSE)); children.append(new DocStyleChange(parent,g_nodeStack.count(),DocStyleChange::Italic,FALSE));
if (tok!=TK_WORD) children.append(new DocWhiteSpace(parent," ")); if (tok!=TK_WORD) children.append(new DocWhiteSpace(parent," "));
if (tok==TK_NEWPARA) goto handlepara; if (tok==TK_NEWPARA) goto handlepara;
else if (tok==TK_WORD) goto reparsetoken; else if (tok==TK_WORD || tok==TK_HTMLTAG) goto reparsetoken;
} }
break; break;
case CMD_BOLD: case CMD_BOLD:
...@@ -799,7 +802,7 @@ reparsetoken: ...@@ -799,7 +802,7 @@ reparsetoken:
children.append(new DocStyleChange(parent,g_nodeStack.count(),DocStyleChange::Bold,FALSE)); children.append(new DocStyleChange(parent,g_nodeStack.count(),DocStyleChange::Bold,FALSE));
if (tok!=TK_WORD) children.append(new DocWhiteSpace(parent," ")); if (tok!=TK_WORD) children.append(new DocWhiteSpace(parent," "));
if (tok==TK_NEWPARA) goto handlepara; if (tok==TK_NEWPARA) goto handlepara;
else if (tok==TK_WORD) goto reparsetoken; else if (tok==TK_WORD || tok==TK_HTMLTAG) goto reparsetoken;
} }
break; break;
case CMD_CODE: case CMD_CODE:
...@@ -809,7 +812,7 @@ reparsetoken: ...@@ -809,7 +812,7 @@ reparsetoken:
children.append(new DocStyleChange(parent,g_nodeStack.count(),DocStyleChange::Code,FALSE)); children.append(new DocStyleChange(parent,g_nodeStack.count(),DocStyleChange::Code,FALSE));
if (tok!=TK_WORD) children.append(new DocWhiteSpace(parent," ")); if (tok!=TK_WORD) children.append(new DocWhiteSpace(parent," "));
if (tok==TK_NEWPARA) goto handlepara; if (tok==TK_NEWPARA) goto handlepara;
else if (tok==TK_WORD) goto reparsetoken; else if (tok==TK_WORD || tok==TK_HTMLTAG) goto reparsetoken;
} }
break; break;
case CMD_HTMLONLY: case CMD_HTMLONLY:
......
...@@ -108,7 +108,7 @@ QIntDict<MemberGroupInfo> Doxygen::memGrpInfoDict(1009); // dictionary of the me ...@@ -108,7 +108,7 @@ QIntDict<MemberGroupInfo> Doxygen::memGrpInfoDict(1009); // dictionary of the me
PageDef *Doxygen::mainPage = 0; PageDef *Doxygen::mainPage = 0;
bool Doxygen::insideMainPage = FALSE; // are we generating docs for the main page? bool Doxygen::insideMainPage = FALSE; // are we generating docs for the main page?
QTextStream Doxygen::tagFile; QTextStream Doxygen::tagFile;
NamespaceDef *Doxygen::globalScope = new NamespaceDef("<globalScope>",1,"<globalScope>"); NamespaceDef *Doxygen::globalScope;
QDict<RefList> *Doxygen::xrefLists = new QDict<RefList>; // dictionary of cross-referenced item lists QDict<RefList> *Doxygen::xrefLists = new QDict<RefList>; // dictionary of cross-referenced item lists
...@@ -116,6 +116,7 @@ bool Doxygen::parseSourcesNeeded = FALSE; ...@@ -116,6 +116,7 @@ bool Doxygen::parseSourcesNeeded = FALSE;
double Doxygen::sysElapsedTime = 0.0; double Doxygen::sysElapsedTime = 0.0;
QTime Doxygen::runningTime; QTime Doxygen::runningTime;
SearchIndex * Doxygen::searchIndex=0; SearchIndex * Doxygen::searchIndex=0;
SDict<DefinitionList> *Doxygen::symbolMap;
static StringList inputFiles; static StringList inputFiles;
static StringDict excludeNameDict(1009); // sections static StringDict excludeNameDict(1009); // sections
...@@ -184,7 +185,7 @@ void statistics() ...@@ -184,7 +185,7 @@ void statistics()
static void addMemberDocs(Entry *root,MemberDef *md, const char *funcDecl, static void addMemberDocs(Entry *root,MemberDef *md, const char *funcDecl,
ArgumentList *al,bool over_load,NamespaceList *nl=0); ArgumentList *al,bool over_load,NamespaceSDict *nl=0);
const char idMask[] = "[A-Za-z_][A-Za-z_0-9]*"; const char idMask[] = "[A-Za-z_][A-Za-z_0-9]*";
QCString spaces; QCString spaces;
...@@ -1186,28 +1187,32 @@ static void findUsingDeclarations(Entry *root) ...@@ -1186,28 +1187,32 @@ static void findUsingDeclarations(Entry *root)
// the possible scopes in which the using statement was found, starting // the possible scopes in which the using statement was found, starting
// with the most inner scope and going to the most outer scope (i.e. // with the most inner scope and going to the most outer scope (i.e.
// file scope). // file scope).
int scopeOffset = scName.length(); // int scopeOffset = scName.length();
do // do
{ // {
QCString scope=scopeOffset>0 ? // QCString scope=scopeOffset>0 ?
scName.left(scopeOffset)+"::" : QCString(); // scName.left(scopeOffset)+"::" : QCString();
//printf("Trying with scope=`%s'\n",scope.data()); // //printf("Trying with scope=`%s'\n",scope.data());
usingCd = getClass(scope+root->name); // usingCd = getClass(scope+root->name);
if (scopeOffset==0) // if (scopeOffset==0)
{ // {
scopeOffset=-1; // scopeOffset=-1;
} // }
else if ((scopeOffset=scName.findRev("::",scopeOffset-1))==-1) // else if ((scopeOffset=scName.findRev("::",scopeOffset-1))==-1)
{ // {
scopeOffset=0; // scopeOffset=0;
} // }
} while (scopeOffset>=0 && usingCd==0); // } while (scopeOffset>=0 && usingCd==0);
usingCd = getResolvedClass(nd,fd,root->name);
//printf("%s -> %p\n",root->name.data(),usingCd); //printf("%s -> %p\n",root->name.data(),usingCd);
if (usingCd==0) // definition not in the input => add an artificial class if (usingCd==0) // definition not in the input => add an artificial class
{ {
Debug::print(Debug::Classes,0," New using class `%s' (sec=0x%08x)! #tArgLists=%d\n",
root->name.data(),root->section,root->tArgLists ? (int)root->tArgLists->count() : -1);
usingCd = new ClassDef( usingCd = new ClassDef(
"<generated>",1, "<using>",1,
root->name,ClassDef::Class); root->name,ClassDef::Class);
Doxygen::hiddenClasses.append(root->name,usingCd); Doxygen::hiddenClasses.append(root->name,usingCd);
usingCd->setClassIsArtificial(); usingCd->setClassIsArtificial();
...@@ -1260,7 +1265,7 @@ static void findUsingDeclImports(Entry *root) ...@@ -1260,7 +1265,7 @@ static void findUsingDeclImports(Entry *root)
{ {
QCString scope=root->name.left(i); QCString scope=root->name.left(i);
QCString memName=root->name.right(root->name.length()-i-2); QCString memName=root->name.right(root->name.length()-i-2);
ClassDef *bcd = getResolvedClass(cd,scope); ClassDef *bcd = getResolvedClass(cd,0,scope); // todo: file in fileScope parameter
if (bcd) if (bcd)
{ {
//printf("found class %s\n",bcd->name().data()); //printf("found class %s\n",bcd->name().data());
...@@ -1721,7 +1726,7 @@ static bool isVarWithConstructor(Entry *root) ...@@ -1721,7 +1726,7 @@ static bool isVarWithConstructor(Entry *root)
if (root->parent->name) ctx=Doxygen::namespaceSDict.find(root->parent->name); if (root->parent->name) ctx=Doxygen::namespaceSDict.find(root->parent->name);
type = root->type; type = root->type;
if (type.left(6)=="const ") type=type.right(type.length()-6); if (type.left(6)=="const ") type=type.right(type.length()-6);
typeIsClass=getResolvedClass(ctx,type)!=0; typeIsClass=getResolvedClass(ctx,fd,type)!=0;
if (typeIsClass) // now we still have to check if the arguments are if (typeIsClass) // now we still have to check if the arguments are
// types or values. Since we do not have complete type info // types or values. Since we do not have complete type info
// we need to rely on heuristics :-( // we need to rely on heuristics :-(
...@@ -1743,7 +1748,7 @@ static bool isVarWithConstructor(Entry *root) ...@@ -1743,7 +1748,7 @@ static bool isVarWithConstructor(Entry *root)
result=FALSE; // arg has (type,name) pair -> function prototype result=FALSE; // arg has (type,name) pair -> function prototype
goto done; goto done;
} }
if (a->type.isEmpty() || getResolvedClass(ctx,a->type)!=0) if (a->type.isEmpty() || getResolvedClass(ctx,fd,a->type)!=0)
{ {
result=FALSE; // arg type is a known type result=FALSE; // arg type is a known type
goto done; goto done;
...@@ -2144,12 +2149,13 @@ static void buildFunctionList(Entry *root) ...@@ -2144,12 +2149,13 @@ static void buildFunctionList(Entry *root)
{ {
Debug::print(Debug::Functions,0, Debug::print(Debug::Functions,0,
"FUNCTION_SEC:\n" "FUNCTION_SEC:\n"
" `%s' `%s'::`%s' `%s' relates=`%s' file=`%s' line=`%d' bodyLine=`%d' #tArgLists=%d mGrpId=%d memSpec=%d proto=%d docFile=%s\n", " `%s' `%s'::`%s' `%s' relates=`%s' relatesDup=`%d' file=`%s' line=`%d' bodyLine=`%d' #tArgLists=%d mGrpId=%d memSpec=%d proto=%d docFile=%s\n",
root->type.data(), root->type.data(),
root->parent->name.data(), root->parent->name.data(),
root->name.data(), root->name.data(),
root->args.data(), root->args.data(),
root->relates.data(), root->relates.data(),
root->relatesDup,
root->fileName.data(), root->fileName.data(),
root->startLine, root->startLine,
root->bodyLine, root->bodyLine,
...@@ -2213,7 +2219,7 @@ static void buildFunctionList(Entry *root) ...@@ -2213,7 +2219,7 @@ static void buildFunctionList(Entry *root)
else if (root->parent && else if (root->parent &&
!(root->parent->section & Entry::COMPOUND_MASK) && !(root->parent->section & Entry::COMPOUND_MASK) &&
!isMember && !isMember &&
root->relates.isEmpty() && (root->relates.isEmpty() || root->relatesDup) &&
root->type.left(7)!="extern " && root->type.left(7)!="extern " &&
root->type.left(8)!="typedef " root->type.left(8)!="typedef "
) )
...@@ -2243,8 +2249,8 @@ static void buildFunctionList(Entry *root) ...@@ -2243,8 +2249,8 @@ static void buildFunctionList(Entry *root)
QCString nsName,rnsName; QCString nsName,rnsName;
if (nd) nsName = nd->name().copy(); if (nd) nsName = nd->name().copy();
if (rnd) rnsName = rnd->name().copy(); if (rnd) rnsName = rnd->name().copy();
NamespaceList *unl = fd ? fd->getUsedNamespaces() : 0; NamespaceSDict *unl = fd ? fd->getUsedNamespaces() : 0;
ClassList *ucl = fd ? fd->getUsedClasses() : 0; ClassSDict *ucl = fd ? fd->getUsedClasses() : 0;
//printf("matching arguments for %s%s %s%s\n", //printf("matching arguments for %s%s %s%s\n",
// md->name().data(),md->argsString(),rname.data(),argListToString(root->argList).data()); // md->name().data(),md->argsString(),rname.data(),argListToString(root->argList).data());
if ( if (
...@@ -2455,7 +2461,13 @@ static void buildFunctionList(Entry *root) ...@@ -2455,7 +2461,13 @@ static void buildFunctionList(Entry *root)
Doxygen::functionNameSDict.append(name,mn); Doxygen::functionNameSDict.append(name,mn);
} }
addMemberToGroups(root,md); addMemberToGroups(root,md);
root->section = Entry::EMPTY_SEC; if (!root->relatesDup) // if this is a relatesalso command, allow find
// Member to pick it up
{
root->section = Entry::EMPTY_SEC; // Otherwise we have finished
// with this entry.
}
} }
else else
{ {
...@@ -2832,6 +2844,9 @@ static void transferRelatedFunctionDocumentation() ...@@ -2832,6 +2844,9 @@ static void transferRelatedFunctionDocumentation()
) )
{ {
//printf(" Found related member `%s'\n",md->name().data()); //printf(" Found related member `%s'\n",md->name().data());
if (rmd->relatedAlso())
md->setRelatedAlso(rmd->relatedAlso());
else
md->makeRelated(); md->makeRelated();
} }
} }
...@@ -2892,27 +2907,27 @@ static ClassDef *findClassWithinClassContext(ClassDef *cd,const QCString &name) ...@@ -2892,27 +2907,27 @@ static ClassDef *findClassWithinClassContext(ClassDef *cd,const QCString &name)
if (nd) // class is inside a namespace if (nd) // class is inside a namespace
{ {
QCString fName = nd->name()+"::"+name; QCString fName = nd->name()+"::"+name;
result = getResolvedClass(cd,fName); result = getResolvedClass(cd,fd,fName);
if (result && result!=cd) if (result && result!=cd)
{ {
return result; return result;
} }
NamespaceList *nl = nd->getUsedNamespaces(); NamespaceSDict *nl = nd->getUsedNamespaces();
if (nl) // try to prepend any of the using namespace scopes. if (nl) // try to prepend any of the using namespace scopes.
{ {
NamespaceListIterator nli(*nl); NamespaceSDict::Iterator nli(*nl);
NamespaceDef *nd; NamespaceDef *nd;
for (nli.toFirst() ; (nd=nli.current()) ; ++nli) for (nli.toFirst() ; (nd=nli.current()) ; ++nli)
{ {
fName = nd->name()+"::"+name; fName = nd->name()+"::"+name;
result = getResolvedClass(cd,fName); result = getResolvedClass(cd,fd,fName);
if (result && result!=cd) return result; if (result && result!=cd) return result;
} }
} }
ClassList *cl = nd->getUsedClasses(); ClassSDict *cl = nd->getUsedClasses();
if (cl) if (cl)
{ {
ClassListIterator cli(*cl); ClassSDict::Iterator cli(*cl);
ClassDef *ucd; ClassDef *ucd;
for (cli.toFirst(); (ucd=cli.current()) ; ++cli) for (cli.toFirst(); (ucd=cli.current()) ; ++cli)
{ {
...@@ -2925,10 +2940,10 @@ static ClassDef *findClassWithinClassContext(ClassDef *cd,const QCString &name) ...@@ -2925,10 +2940,10 @@ static ClassDef *findClassWithinClassContext(ClassDef *cd,const QCString &name)
// TODO: check any inbetween namespaces as well! // TODO: check any inbetween namespaces as well!
if (fd) // and in the global namespace if (fd) // and in the global namespace
{ {
ClassList *cl = fd->getUsedClasses(); ClassSDict *cl = fd->getUsedClasses();
if (cl) if (cl)
{ {
ClassListIterator cli(*cl); ClassSDict::Iterator cli(*cl);
ClassDef *ucd; ClassDef *ucd;
for (cli.toFirst(); (ucd=cli.current()); ++cli) for (cli.toFirst(); (ucd=cli.current()); ++cli)
{ {
...@@ -2946,25 +2961,25 @@ static ClassDef *findClassWithinClassContext(ClassDef *cd,const QCString &name) ...@@ -2946,25 +2961,25 @@ static ClassDef *findClassWithinClassContext(ClassDef *cd,const QCString &name)
{ {
// look for the using statement in this file in which the // look for the using statement in this file in which the
// class was found // class was found
NamespaceList *nl = fd->getUsedNamespaces(); NamespaceSDict *nl = fd->getUsedNamespaces();
if (nl) // try to prepend any of the using namespace scopes. if (nl) // try to prepend any of the using namespace scopes.
{ {
NamespaceListIterator nli(*nl); NamespaceSDict::Iterator nli(*nl);
NamespaceDef *nd; NamespaceDef *nd;
for (nli.toFirst() ; (nd=nli.current()) ; ++nli) for (nli.toFirst() ; (nd=nli.current()) ; ++nli)
{ {
QCString fName = nd->name()+"::"+name; QCString fName = nd->name()+"::"+name;
result=getResolvedClass(cd,fName); result=getResolvedClass(cd,fd,fName);
if (result && result!=cd) if (result && result!=cd)
{ {
return result; return result;
} }
} }
} }
ClassList *cl = fd->getUsedClasses(); ClassSDict *cl = fd->getUsedClasses();
if (cl) if (cl)
{ {
ClassListIterator cli(*cl); ClassSDict::Iterator cli(*cl);
ClassDef *ucd; ClassDef *ucd;
for (cli.toFirst(); (ucd=cli.current()) ; ++cli) for (cli.toFirst(); (ucd=cli.current()) ; ++cli)
{ {
...@@ -2976,7 +2991,7 @@ static ClassDef *findClassWithinClassContext(ClassDef *cd,const QCString &name) ...@@ -2976,7 +2991,7 @@ static ClassDef *findClassWithinClassContext(ClassDef *cd,const QCString &name)
} }
} }
return getResolvedClass(cd,name); return getResolvedClass(cd,fd,name);
} }
enum FindBaseClassRelation_Mode enum FindBaseClassRelation_Mode
...@@ -3325,7 +3340,11 @@ static bool findClassRelation( ...@@ -3325,7 +3340,11 @@ static bool findClassRelation(
(removeRedundantWhiteSpace(baseClassName)); (removeRedundantWhiteSpace(baseClassName));
bool baseClassIsTypeDef; bool baseClassIsTypeDef;
QCString templSpec; QCString templSpec;
ClassDef *baseClass=getResolvedClass(explicitGlobalScope ? 0 : cd,baseClassName,&baseClassIsTypeDef,&templSpec); ClassDef *baseClass=getResolvedClass(explicitGlobalScope ? 0 : cd,
cd->getFileDef(), // todo: is this ok?
baseClassName,
&baseClassIsTypeDef,
&templSpec);
//printf("baseClassName=%s baseClass=%p cd=%p\n",baseClassName.data(),baseClass,cd); //printf("baseClassName=%s baseClass=%p cd=%p\n",baseClassName.data(),baseClass,cd);
//printf(" root->name=`%s' baseClassName=`%s' baseClass=%s templSpec=%s\n", //printf(" root->name=`%s' baseClassName=`%s' baseClass=%s templSpec=%s\n",
// root->name.data(), // root->name.data(),
...@@ -3374,7 +3393,7 @@ static bool findClassRelation( ...@@ -3374,7 +3393,7 @@ static bool findClassRelation(
{ {
templSpec=baseClassName.mid(i,e-i); templSpec=baseClassName.mid(i,e-i);
baseClassName=baseClassName.left(i)+baseClassName.right(baseClassName.length()-e); baseClassName=baseClassName.left(i)+baseClassName.right(baseClassName.length()-e);
baseClass=getResolvedClass(cd,baseClassName); baseClass=getResolvedClass(cd,cd->getFileDef(),baseClassName);
//printf("baseClass=%p -> baseClass=%s templSpec=%s\n", //printf("baseClass=%p -> baseClass=%s templSpec=%s\n",
// baseClass,baseClassName.data(),templSpec.data()); // baseClass,baseClassName.data(),templSpec.data());
} }
...@@ -3386,7 +3405,7 @@ static bool findClassRelation( ...@@ -3386,7 +3405,7 @@ static bool findClassRelation(
{ {
// replace any namespace aliases // replace any namespace aliases
replaceNamespaceAliases(baseClassName,i); replaceNamespaceAliases(baseClassName,i);
baseClass=getResolvedClass(cd,baseClassName); baseClass=getResolvedClass(cd,cd->getFileDef(),baseClassName);
found=baseClass!=0 && baseClass!=cd; found=baseClass!=0 && baseClass!=cd;
} }
...@@ -3818,7 +3837,7 @@ static void addMemberDocs(Entry *root, ...@@ -3818,7 +3837,7 @@ static void addMemberDocs(Entry *root,
MemberDef *md, const char *funcDecl, MemberDef *md, const char *funcDecl,
ArgumentList *al, ArgumentList *al,
bool over_load, bool over_load,
NamespaceList *nl NamespaceSDict *nl
) )
{ {
//printf("addMemberDocs: `%s'::`%s' `%s' funcDecl=`%s' memSpec=%d\n", //printf("addMemberDocs: `%s'::`%s' `%s' funcDecl=`%s' memSpec=%d\n",
...@@ -3966,7 +3985,7 @@ static ClassDef *findClassDefinition(FileDef *fd,NamespaceDef *nd, ...@@ -3966,7 +3985,7 @@ static ClassDef *findClassDefinition(FileDef *fd,NamespaceDef *nd,
ClassDef *tcd = getClass(scopeName); ClassDef *tcd = getClass(scopeName);
if (tcd==0) // try using declaration if (tcd==0) // try using declaration
{ {
ClassList *cl = 0; ClassSDict *cl = 0;
if (nd) if (nd)
{ {
cl=nd->getUsedClasses(); cl=nd->getUsedClasses();
...@@ -3977,7 +3996,7 @@ static ClassDef *findClassDefinition(FileDef *fd,NamespaceDef *nd, ...@@ -3977,7 +3996,7 @@ static ClassDef *findClassDefinition(FileDef *fd,NamespaceDef *nd,
} }
if (cl) if (cl)
{ {
ClassListIterator cli(*cl); ClassSDict::Iterator cli(*cl);
ClassDef *cd; ClassDef *cd;
for (;(cd=cli.current()) && tcd==0;++cli) for (;(cd=cli.current()) && tcd==0;++cli)
{ {
...@@ -3999,7 +4018,7 @@ static ClassDef *findClassDefinition(FileDef *fd,NamespaceDef *nd, ...@@ -3999,7 +4018,7 @@ static ClassDef *findClassDefinition(FileDef *fd,NamespaceDef *nd,
} }
if (tcd==0) // try using directive if (tcd==0) // try using directive
{ {
NamespaceList *nl = 0; NamespaceSDict *nl = 0;
if (nd) if (nd)
{ {
nl=nd->getUsedNamespaces(); nl=nd->getUsedNamespaces();
...@@ -4010,7 +4029,7 @@ static ClassDef *findClassDefinition(FileDef *fd,NamespaceDef *nd, ...@@ -4010,7 +4029,7 @@ static ClassDef *findClassDefinition(FileDef *fd,NamespaceDef *nd,
} }
if (nl) if (nl)
{ {
NamespaceListIterator nli(*nl); NamespaceSDict::Iterator nli(*nl);
NamespaceDef *nd; NamespaceDef *nd;
for (;(nd=nli.current()) && tcd==0;++nli) for (;(nd=nli.current()) && tcd==0;++nli)
{ {
...@@ -4061,13 +4080,13 @@ static bool findGlobalMember(Entry *root, ...@@ -4061,13 +4080,13 @@ static bool findGlobalMember(Entry *root,
// namespaceName.data(),nd ? nd->name().data() : "<none>"); // namespaceName.data(),nd ? nd->name().data() : "<none>");
FileDef *fd=findFileDef(Doxygen::inputNameDict,root->fileName,ambig); FileDef *fd=findFileDef(Doxygen::inputNameDict,root->fileName,ambig);
//printf("File %s\n",fd ? fd->name().data() : "<none>"); //printf("File %s\n",fd ? fd->name().data() : "<none>");
NamespaceList *nl = fd ? fd->getUsedNamespaces() : 0; NamespaceSDict *nl = fd ? fd->getUsedNamespaces() : 0;
ClassList *cl = fd ? fd->getUsedClasses() : 0; ClassSDict *cl = fd ? fd->getUsedClasses() : 0;
//printf("NamespaceList %p\n",nl); //printf("NamespaceList %p\n",nl);
// search in the list of namespaces that are imported via a // search in the list of namespaces that are imported via a
// using declaration // using declaration
bool viaUsingDirective = nl && nd && nl->find(nd)!=-1; bool viaUsingDirective = nl && nd && nl->find(nd->qualifiedName())!=0;
if ((namespaceName.isEmpty() && nd==0) || // not in a namespace if ((namespaceName.isEmpty() && nd==0) || // not in a namespace
(nd && nd->name()==namespaceName) || // or in the same namespace (nd && nd->name()==namespaceName) || // or in the same namespace
...@@ -4566,58 +4585,58 @@ static void findMember(Entry *root, ...@@ -4566,58 +4585,58 @@ static void findMember(Entry *root,
// list of namespaces using in the file/namespace that this // list of namespaces using in the file/namespace that this
// member definition is part of // member definition is part of
NamespaceList *nl = new NamespaceList; NamespaceSDict *nl = new NamespaceSDict;
if (nd) if (nd)
{ {
NamespaceList *nnl = nd->getUsedNamespaces(); NamespaceSDict *nnl = nd->getUsedNamespaces();
if (nnl) if (nnl)
{ {
NamespaceDef *nnd = nnl->first(); NamespaceDef *nnd;
while (nnd) NamespaceSDict::Iterator nsdi(*nnl);
for (nsdi.toFirst();(nnd=nsdi.current());++nsdi)
{ {
nl->append(nnd); nl->append(nnd->qualifiedName(),nnd);
nnd = nnl->next();
} }
} }
} }
if (fd) if (fd)
{ {
NamespaceList *fnl = fd->getUsedNamespaces(); NamespaceSDict *fnl = fd->getUsedNamespaces();
if (fnl) if (fnl)
{ {
NamespaceDef *fnd = fnl->first(); NamespaceDef *fnd;
while (fnd) NamespaceSDict::Iterator nsdi(*fnl);
for (nsdi.toFirst();(fnd=nsdi.current());++nsdi)
{ {
nl->append(fnd); nl->append(fnd->qualifiedName(),fnd);
fnd = fnl->next();
} }
} }
} }
ClassList *cl = new ClassList; ClassSDict *cl = new ClassSDict(17);
if (nd) if (nd)
{ {
ClassList *ncl = nd->getUsedClasses(); ClassSDict *ncl = nd->getUsedClasses();
if (ncl) if (ncl)
{ {
ClassDef *ncd = ncl->first(); ClassSDict::Iterator csdi(*ncl);
while (ncd) ClassDef *ncd;
for (csdi.toFirst();(ncd=csdi.current());++csdi)
{ {
cl->append(ncd); cl->append(ncd->qualifiedName(),ncd);
ncd = ncl->next();
} }
} }
} }
if (fd) if (fd)
{ {
ClassList *fcl = fd->getUsedClasses(); ClassSDict *fcl = fd->getUsedClasses();
if (fcl) if (fcl)
{ {
ClassDef *fcd = fcl->first(); ClassSDict::Iterator csdi(*fcl);
while (fcd) ClassDef *fcd;
for (csdi.toFirst();(fcd=csdi.current());++csdi)
{ {
cl->append(fcd); cl->append(fcd->qualifiedName(),fcd);
fcd = fcl->next();
} }
} }
} }
...@@ -4804,7 +4823,8 @@ static void findMember(Entry *root, ...@@ -4804,7 +4823,8 @@ static void findMember(Entry *root,
} }
else if (isRelated && !root->relates.isEmpty()) else if (isRelated && !root->relates.isEmpty())
{ {
Debug::print(Debug::FindMembers,0,"2. related function\n"); Debug::print(Debug::FindMembers,0,"2. related function\n"
" scopeName=%s className=%s\n",scopeName.data(),className.data());
if (className.isEmpty()) className=root->relates.copy(); if (className.isEmpty()) className=root->relates.copy();
ClassDef *cd; ClassDef *cd;
//printf("scopeName=`%s' className=`%s'\n",scopeName.data(),className.data()); //printf("scopeName=`%s' className=`%s'\n",scopeName.data(),className.data());
...@@ -4938,6 +4958,7 @@ static void findMember(Entry *root, ...@@ -4938,6 +4958,7 @@ static void findMember(Entry *root,
cd->insertMember(md); cd->insertMember(md);
cd->insertUsedFile(root->fileName); cd->insertUsedFile(root->fileName);
md->setRefItems(root->sli); md->setRefItems(root->sli);
if (root->relatesDup) md->setRelatedAlso(cd);
addMemberToGroups(root,md); addMemberToGroups(root,md);
//printf("Adding member=%s\n",md->name().data()); //printf("Adding member=%s\n",md->name().data());
if (newMemberName) if (newMemberName)
...@@ -4992,7 +5013,7 @@ static void findMemberDocumentation(Entry *root) ...@@ -4992,7 +5013,7 @@ static void findMemberDocumentation(Entry *root)
{ {
int i=-1,l; int i=-1,l;
Debug::print(Debug::FindMembers,0, Debug::print(Debug::FindMembers,0,
"root->type=`%s' root->inside=`%s' root->name=`%s' root->args=`%s' section=%x root->memSpec=%d root->mGrpId=%d\n", "findMemberDocumentation(): root->type=`%s' root->inside=`%s' root->name=`%s' root->args=`%s' section=%x root->memSpec=%d root->mGrpId=%d\n",
root->type.data(),root->inside.data(),root->name.data(),root->args.data(),root->section,root->memSpec,root->mGrpId root->type.data(),root->inside.data(),root->name.data(),root->args.data(),root->section,root->memSpec,root->mGrpId
); );
bool isFunc=TRUE; bool isFunc=TRUE;
...@@ -5825,6 +5846,45 @@ static void inheritDocumentation() ...@@ -5825,6 +5846,45 @@ static void inheritDocumentation()
//---------------------------------------------------------------------------- //----------------------------------------------------------------------------
static void combineUsingRelations()
{
// for each file
FileNameListIterator fnli(Doxygen::inputNameList);
FileName *fn;
for (fnli.toFirst();(fn=fnli.current());++fnli)
{
FileNameIterator fni(*fn);
FileDef *fd;
for (fni.toFirst();(fd=fni.current());++fni)
{
fd->visited=FALSE;
}
}
for (fnli.toFirst();(fn=fnli.current());++fnli)
{
FileNameIterator fni(*fn);
FileDef *fd;
for (fni.toFirst();(fd=fni.current());++fni)
{
fd->combineUsingRelations();
}
}
// for each namespace
NamespaceSDict::Iterator nli(Doxygen::namespaceSDict);
NamespaceDef *nd;
for (nli.toFirst() ; (nd=nli.current()) ; ++nli )
{
nd->visited=FALSE;
}
for (nli.toFirst() ; (nd=nli.current()) ; ++nli )
{
nd->combineUsingRelations();
}
}
//----------------------------------------------------------------------------
static void addMembersToMemberGroup() static void addMembersToMemberGroup()
{ {
// for each class // for each class
...@@ -7152,6 +7212,9 @@ void initDoxygen() ...@@ -7152,6 +7212,9 @@ void initDoxygen()
setlocale(LC_ALL,""); setlocale(LC_ALL,"");
setlocale(LC_NUMERIC,"C"); setlocale(LC_NUMERIC,"C");
#endif #endif
Doxygen::symbolMap = new SDict<DefinitionList>(1000);
Doxygen::symbolMap->setAutoDelete(TRUE);
Doxygen::globalScope = new NamespaceDef("<globalScope>",1,"<globalScope>");
Doxygen::runningTime.start(); Doxygen::runningTime.start();
initPreprocessor(); initPreprocessor();
...@@ -7188,6 +7251,10 @@ void cleanUpDoxygen() ...@@ -7188,6 +7251,10 @@ void cleanUpDoxygen()
delete outputList; delete outputList;
CmdMapper::freeInstance(); CmdMapper::freeInstance();
HtmlTagMapper::freeInstance(); HtmlTagMapper::freeInstance();
//delete Doxygen::symbolMap; <- we cannot do this unless all static lists
// (such as Doxygen::namespaceSDict)
// with objects based on Definition are made
// dynamic first
} }
void readConfiguration(int argc, char **argv) void readConfiguration(int argc, char **argv)
...@@ -7927,7 +7994,6 @@ void parseInput() ...@@ -7927,7 +7994,6 @@ void parseInput()
buildClassList(root); buildClassList(root);
buildClassDocList(root); buildClassDocList(root);
resolveClassNestingRelations(); resolveClassNestingRelations();
findUsingDeclarations(root);
msg("Building example list...\n"); msg("Building example list...\n");
buildExampleList(root); buildExampleList(root);
...@@ -7968,6 +8034,7 @@ void parseInput() ...@@ -7968,6 +8034,7 @@ void parseInput()
msg("Searching for members imported via using declarations...\n"); msg("Searching for members imported via using declarations...\n");
findUsingDeclImports(root); findUsingDeclImports(root);
findUsingDeclarations(root);
msg("Building page list...\n"); msg("Building page list...\n");
buildPageList(root); buildPageList(root);
...@@ -8026,6 +8093,21 @@ void generateOutput() ...@@ -8026,6 +8093,21 @@ void generateOutput()
* Initialize output generators * * Initialize output generators *
**************************************************************************/ **************************************************************************/
//// dump all symbols
//SDict<DefinitionList>::Iterator sdi(Doxygen::symbolMap);
//DefinitionList *dl;
//for (sdi.toFirst();(dl=sdi.current());++sdi)
//{
// DefinitionListIterator dli(*dl);
// Definition *d;
// printf("Symbol: ");
// for (dli.toFirst();(d=dli.current());++dli)
// {
// printf("%s ",d->qualifiedName().data());
// }
// printf("\n");
//}
initDocParser(); initDocParser();
//{ //{
...@@ -8119,6 +8201,9 @@ void generateOutput() ...@@ -8119,6 +8201,9 @@ void generateOutput()
msg("Resolving user defined references...\n"); msg("Resolving user defined references...\n");
resolveUserReferences(); resolveUserReferences();
msg("Combining using relations...\n");
combineUsingRelations();
msg("Finding anchors and sections in the documentation...\n"); msg("Finding anchors and sections in the documentation...\n");
findSectionsInDocumentation(); findSectionsInDocumentation();
......
...@@ -99,6 +99,7 @@ class Doxygen ...@@ -99,6 +99,7 @@ class Doxygen
static double sysElapsedTime; static double sysElapsedTime;
static QTime runningTime; static QTime runningTime;
static SearchIndex *searchIndex; static SearchIndex *searchIndex;
static SDict<DefinitionList> *symbolMap;
}; };
void initDoxygen(); void initDoxygen();
......
...@@ -42,6 +42,7 @@ Entry::Entry() ...@@ -42,6 +42,7 @@ Entry::Entry()
mGrpId = -1; mGrpId = -1;
tagInfo = 0; tagInfo = 0;
sli = 0; sli = 0;
relatesDup = FALSE;
groupDocType = GROUPDOC_NORMAL; groupDocType = GROUPDOC_NORMAL;
reset(); reset();
} }
...@@ -69,6 +70,7 @@ Entry::Entry(const Entry &e) ...@@ -69,6 +70,7 @@ Entry::Entry(const Entry &e)
docLine = e.docLine; docLine = e.docLine;
docFile = e.docFile.copy(); docFile = e.docFile.copy();
relates = e.relates.copy(); relates = e.relates.copy();
relatesDup = e.relatesDup;
brief = e.brief.copy(); brief = e.brief.copy();
briefLine = e.briefLine; briefLine = e.briefLine;
briefFile = e.briefFile.copy(); briefFile = e.briefFile.copy();
...@@ -227,6 +229,7 @@ void Entry::reset() ...@@ -227,6 +229,7 @@ void Entry::reset()
docFile.resize(0); docFile.resize(0);
docLine=-1; docLine=-1;
relates.resize(0); relates.resize(0);
relatesDup=FALSE;
brief.resize(0); brief.resize(0);
briefFile.resize(0); briefFile.resize(0);
briefLine=-1; briefLine=-1;
......
...@@ -275,6 +275,7 @@ class Entry ...@@ -275,6 +275,7 @@ class Entry
int briefLine; //!< line number at which the brief desc. was found int briefLine; //!< line number at which the brief desc. was found
QCString briefFile; //!< file in which the brief desc. was found QCString briefFile; //!< file in which the brief desc. was found
QCString relates; //!< related class (doc block) QCString relates; //!< related class (doc block)
bool relatesDup; //!< keep duplicate doc in original file also
QCString inside; //!< name of the class in which documents are found QCString inside; //!< name of the class in which documents are found
QCString exception; //!< throw specification QCString exception; //!< throw specification
int bodyLine; //!< line number of the definition in the source int bodyLine; //!< line number of the definition in the source
......
...@@ -263,6 +263,7 @@ void FileDef::writeDocumentation(OutputList &ol) ...@@ -263,6 +263,7 @@ void FileDef::writeDocumentation(OutputList &ol)
if (fd) if (fd)
{ {
isIDLorJava = fd->name().right(4)==".idl" || isIDLorJava = fd->name().right(4)==".idl" ||
fd->name().right(5)==".pidl" ||
fd->name().right(5)==".java"; fd->name().right(5)==".java";
} }
ol.startTypewriter(); ol.startTypewriter();
...@@ -648,18 +649,24 @@ void FileDef::addUsingDirective(NamespaceDef *nd) ...@@ -648,18 +649,24 @@ void FileDef::addUsingDirective(NamespaceDef *nd)
{ {
if (usingDirList==0) if (usingDirList==0)
{ {
usingDirList = new NamespaceList; usingDirList = new NamespaceSDict;
}
if (usingDirList->find(nd->qualifiedName())==0)
{
usingDirList->append(nd->qualifiedName(),nd);
} }
usingDirList->append(nd);
} }
void FileDef::addUsingDeclaration(ClassDef *cd) void FileDef::addUsingDeclaration(ClassDef *cd)
{ {
if (usingDeclList==0) if (usingDeclList==0)
{ {
usingDeclList = new ClassList; usingDeclList = new ClassSDict;
}
if (usingDeclList->find(cd->qualifiedName())==0)
{
usingDeclList->append(cd->qualifiedName(),cd);
} }
usingDeclList->append(cd);
} }
void FileDef::addIncludeDependency(FileDef *fd,const char *incName,bool local) void FileDef::addIncludeDependency(FileDef *fd,const char *incName,bool local)
...@@ -706,18 +713,18 @@ void FileDef::addIncludedUsingDirectives() ...@@ -706,18 +713,18 @@ void FileDef::addIncludedUsingDirectives()
{ {
if (ii->fileDef && ii->fileDef!=this) if (ii->fileDef && ii->fileDef!=this)
{ {
NamespaceList *unl = ii->fileDef->usingDirList; NamespaceSDict *unl = ii->fileDef->usingDirList;
if (unl) if (unl)
{ {
NamespaceListIterator nli(*unl); NamespaceSDict::Iterator nli(*unl);
NamespaceDef *nd; NamespaceDef *nd;
for (nli.toLast();(nd=nli.current());--nli) for (nli.toLast();(nd=nli.current());--nli)
{ {
// append each using directive found in a #include file // append each using directive found in a #include file
if (usingDirList==0) usingDirList = new NamespaceList; if (usingDirList==0) usingDirList = new NamespaceSDict;
//printf("Prepending used namespace %s to the list of file %s\n", //printf("Prepending used namespace %s to the list of file %s\n",
// nd->name().data(),name().data()); // nd->name().data(),name().data());
usingDirList->prepend(nd); usingDirList->prepend(nd->qualifiedName(),nd);
} }
} }
} }
...@@ -994,3 +1001,44 @@ void generateFileTree(QTextStream &t) ...@@ -994,3 +1001,44 @@ void generateFileTree(QTextStream &t)
delete root; delete root;
} }
void FileDef::combineUsingRelations()
{
if (visited) return; // already done
visited=TRUE;
if (usingDirList)
{
NamespaceSDict::Iterator nli(*usingDirList);
NamespaceDef *nd;
for (nli.toFirst();(nd=nli.current());++nli)
{
nd->combineUsingRelations();
}
for (nli.toFirst();(nd=nli.current());++nli)
{
// add used namespaces of namespace nd to this namespace
if (nd->getUsedNamespaces())
{
NamespaceSDict::Iterator unli(*nd->getUsedNamespaces());
NamespaceDef *und;
for (unli.toFirst();(und=unli.current());++unli)
{
//printf("Adding namespace %s to the using list of %s\n",und->qualifiedName().data(),qualifiedName().data());
addUsingDirective(und);
}
}
// add used classes of namespace nd to this namespace
if (nd->getUsedClasses())
{
ClassSDict::Iterator cli(*nd->getUsedClasses());
ClassDef *ucd;
for (cli.toFirst();(ucd=cli.current());++cli)
{
//printf("Adding class %s to the using list of %s\n",cd->qualifiedName().data(),qualifiedName().data());
addUsingDeclaration(ucd);
}
}
}
}
}
...@@ -133,9 +133,10 @@ class FileDef : public Definition ...@@ -133,9 +133,10 @@ class FileDef : public Definition
PackageDef *packageDef() const { return package; } PackageDef *packageDef() const { return package; }
void addUsingDirective(NamespaceDef *nd); void addUsingDirective(NamespaceDef *nd);
NamespaceList *getUsedNamespaces() const { return usingDirList; } NamespaceSDict *getUsedNamespaces() const { return usingDirList; }
void addUsingDeclaration(ClassDef *cd); void addUsingDeclaration(ClassDef *cd);
ClassList *getUsedClasses() const { return usingDeclList; } ClassSDict *getUsedClasses() const { return usingDeclList; }
void combineUsingRelations();
bool generateSourceFile() const; bool generateSourceFile() const;
...@@ -186,8 +187,8 @@ class FileDef : public Definition ...@@ -186,8 +187,8 @@ class FileDef : public Definition
QList<IncludeInfo> *includeList; QList<IncludeInfo> *includeList;
QDict<IncludeInfo> *includedByDict; QDict<IncludeInfo> *includedByDict;
QList<IncludeInfo> *includedByList; QList<IncludeInfo> *includedByList;
NamespaceList *usingDirList; NamespaceSDict *usingDirList;
ClassList *usingDeclList; ClassSDict *usingDeclList;
//DefineList *defineList; //DefineList *defineList;
QCString path; QCString path;
QCString filepath; QCString filepath;
......
...@@ -401,6 +401,7 @@ static void writeDefaultStyleSheetPart3(QTextStream &t) ...@@ -401,6 +401,7 @@ static void writeDefaultStyleSheetPart3(QTextStream &t)
t << "\\setlength{\\parskip}{0.2cm}\n"; t << "\\setlength{\\parskip}{0.2cm}\n";
t << "\\addtocounter{secnumdepth}{1}\n"; t << "\\addtocounter{secnumdepth}{1}\n";
t << "\\sloppy\n"; t << "\\sloppy\n";
t << "\\usepackage[T1]{fontenc}\n";
} }
void LatexGenerator::writeHeaderFile(QFile &f) void LatexGenerator::writeHeaderFile(QFile &f)
......
...@@ -271,6 +271,7 @@ MemberDef::MemberDef(const char *df,int dl, ...@@ -271,6 +271,7 @@ MemberDef::MemberDef(const char *df,int dl,
classDef=0; classDef=0;
fileDef=0; fileDef=0;
redefines=0; redefines=0;
m_relatedAlso=0;
redefinedBy=0; redefinedBy=0;
nspace=0; nspace=0;
memDef=0; memDef=0;
...@@ -370,9 +371,11 @@ MemberDef::MemberDef(const char *df,int dl, ...@@ -370,9 +371,11 @@ MemberDef::MemberDef(const char *df,int dl,
{ {
declArgList = 0; declArgList = 0;
} }
m_templateMaster=0; m_templateMaster = 0;
classSectionSDict=0; classSectionSDict = 0;
docsForDefinition=TRUE; docsForDefinition = TRUE;
m_isTypedefValCached = FALSE;
m_cachedTypedefValue = 0;
} }
/*! Destroys the member definition. */ /*! Destroys the member definition. */
......
...@@ -175,6 +175,10 @@ class MemberDef : public Definition ...@@ -175,6 +175,10 @@ class MemberDef : public Definition
MemberDef *reimplements() const; MemberDef *reimplements() const;
MemberList *reimplementedBy() const; MemberList *reimplementedBy() const;
// For function documentation that can also be found in a class's related func section.
void setRelatedAlso(ClassDef *cd) { m_relatedAlso=cd; }
ClassDef *relatedAlso() const { return m_relatedAlso; }
// enumeration specific members // enumeration specific members
void insertEnumField(MemberDef *md); void insertEnumField(MemberDef *md);
void setEnumScope(MemberDef *md); void setEnumScope(MemberDef *md);
...@@ -248,6 +252,11 @@ class MemberDef : public Definition ...@@ -248,6 +252,11 @@ class MemberDef : public Definition
void setBodyMember(MemberDef *md) { bodyMemb = md; } void setBodyMember(MemberDef *md) { bodyMemb = md; }
void setDocsForDefinition(bool b) { docsForDefinition = b; } void setDocsForDefinition(bool b) { docsForDefinition = b; }
// cached typedef functions
bool isTypedefValCached() const { return m_isTypedefValCached; }
ClassDef *getCachedTypedefVal() const { return m_cachedTypedefValue; }
void cacheTypedefVal(ClassDef *val) { m_isTypedefValCached=TRUE; m_cachedTypedefValue=val; }
// declaration <-> definition relation // declaration <-> definition relation
void setMemberDefinition(MemberDef *md) { memDef=md; } void setMemberDefinition(MemberDef *md) { memDef=md; }
void setMemberDeclaration(MemberDef *md) { memDec=md; } void setMemberDeclaration(MemberDef *md) { memDec=md; }
...@@ -270,6 +279,7 @@ class MemberDef : public Definition ...@@ -270,6 +279,7 @@ class MemberDef : public Definition
MemberList *redefinedBy; // the list of members that redefine this one MemberList *redefinedBy; // the list of members that redefine this one
MemberDef *memDef; // member definition for this declaration MemberDef *memDef; // member definition for this declaration
MemberDef *memDec; // member declaration for this definition MemberDef *memDec; // member declaration for this definition
ClassDef *m_relatedAlso; // points to class marked by relatedAlso
ExampleSDict *exampleSDict; // a dictionary of all examples for quick access ExampleSDict *exampleSDict; // a dictionary of all examples for quick access
...@@ -332,6 +342,10 @@ class MemberDef : public Definition ...@@ -332,6 +342,10 @@ class MemberDef : public Definition
MemberDef(const MemberDef &); MemberDef(const MemberDef &);
MemberDef &operator=(const MemberDef &); MemberDef &operator=(const MemberDef &);
static int s_indentLevel; static int s_indentLevel;
bool m_isTypedefValCached;
ClassDef *m_cachedTypedefValue;
}; };
#endif #endif
...@@ -363,18 +363,24 @@ void NamespaceDef::addUsingDirective(NamespaceDef *nd) ...@@ -363,18 +363,24 @@ void NamespaceDef::addUsingDirective(NamespaceDef *nd)
{ {
if (usingDirList==0) if (usingDirList==0)
{ {
usingDirList = new NamespaceList; usingDirList = new NamespaceSDict;
}
if (usingDirList->find(nd->qualifiedName())==0)
{
usingDirList->append(nd->qualifiedName(),nd);
} }
usingDirList->append(nd);
} }
void NamespaceDef::addUsingDeclaration(ClassDef *cd) void NamespaceDef::addUsingDeclaration(ClassDef *cd)
{ {
if (usingDeclList==0) if (usingDeclList==0)
{ {
usingDeclList = new ClassList; usingDeclList = new ClassSDict;
}
if (usingDeclList->find(cd->qualifiedName())==0)
{
usingDeclList->append(cd->qualifiedName(),cd);
} }
usingDeclList->append(cd);
} }
QCString NamespaceDef::getOutputFileBase() const QCString NamespaceDef::getOutputFileBase() const
...@@ -418,3 +424,43 @@ QCString NamespaceDef::displayName() const ...@@ -418,3 +424,43 @@ QCString NamespaceDef::displayName() const
return result; return result;
} }
void NamespaceDef::combineUsingRelations()
{
if (visited) return; // already done
visited=TRUE;
if (usingDirList)
{
NamespaceSDict::Iterator nli(*usingDirList);
NamespaceDef *nd;
for (nli.toFirst();(nd=nli.current());++nli)
{
nd->combineUsingRelations();
}
for (nli.toFirst();(nd=nli.current());++nli)
{
// add used namespaces of namespace nd to this namespace
if (nd->getUsedNamespaces())
{
NamespaceSDict::Iterator unli(*nd->getUsedNamespaces());
NamespaceDef *und;
for (unli.toFirst();(und=unli.current());++unli)
{
//printf("Adding namespace %s to the using list of %s\n",und->qualifiedName().data(),qualifiedName().data());
addUsingDirective(und);
}
}
// add used classes of namespace nd to this namespace
if (nd->getUsedClasses())
{
ClassSDict::Iterator cli(*nd->getUsedClasses());
ClassDef *ucd;
for (cli.toFirst();(ucd=cli.current());++cli)
{
//printf("Adding class %s to the using list of %s\n",cd->qualifiedName().data(),qualifiedName().data());
addUsingDeclaration(ucd);
}
}
}
}
}
...@@ -54,9 +54,10 @@ class NamespaceDef : public Definition ...@@ -54,9 +54,10 @@ class NamespaceDef : public Definition
void computeAnchors(); void computeAnchors();
int countMembers(); int countMembers();
void addUsingDirective(NamespaceDef *nd); void addUsingDirective(NamespaceDef *nd);
NamespaceList *getUsedNamespaces() const { return usingDirList; } NamespaceSDict *getUsedNamespaces() const { return usingDirList; }
void addUsingDeclaration(ClassDef *cd); void addUsingDeclaration(ClassDef *cd);
ClassList *getUsedClasses() const { return usingDeclList; } ClassSDict *getUsedClasses() const { return usingDeclList; }
void combineUsingRelations();
QCString displayName() const; QCString displayName() const;
bool isLinkableInProject() const bool isLinkableInProject() const
...@@ -108,14 +109,16 @@ class NamespaceDef : public Definition ...@@ -108,14 +109,16 @@ class NamespaceDef : public Definition
/*! Namespaces inside this namespace */ /*! Namespaces inside this namespace */
NamespaceSDict *namespaceSDict; NamespaceSDict *namespaceSDict;
bool visited;
private: private:
//QCString reference; //QCString reference;
QCString fileName; QCString fileName;
QStrList files; QStrList files;
NamespaceList *usingDirList; NamespaceSDict *usingDirList;
ClassList *usingDeclList; ClassSDict *usingDeclList;
SDict<Definition> *m_innerCompounds; SDict<Definition> *m_innerCompounds;
MemberList allMemberList; MemberList allMemberList;
......
...@@ -22,7 +22,6 @@ ...@@ -22,7 +22,6 @@
*/ */
#include <stdio.h> #include <stdio.h>
//#include <iostream.h>
#include <assert.h> #include <assert.h>
#include <ctype.h> #include <ctype.h>
......
...@@ -58,6 +58,7 @@ static int lastContext; ...@@ -58,6 +58,7 @@ static int lastContext;
static int lastCContext; static int lastCContext;
static int lastDocContext; static int lastDocContext;
static int lastDocRelContext; static int lastDocRelContext;
static int lastDocRelAlsoContext;
static int lastCPPContext; static int lastCPPContext;
static int lastSkipSharpContext; static int lastSkipSharpContext;
static int lastSkipRoundContext; static int lastSkipRoundContext;
...@@ -428,7 +429,8 @@ static QCString extractName(const QCString &s) ...@@ -428,7 +429,8 @@ static QCString extractName(const QCString &s)
static void setContext() static void setContext()
{ {
QCString fileName = yyFileName; QCString fileName = yyFileName;
insideIDL = fileName.right(4)==".idl" || fileName.right(4)==".odl"; insideIDL = fileName.right(4)==".idl" || fileName.right(5)==".pidl" ||
fileName.right(4)==".odl";
insideJava = fileName.right(5)==".java"; insideJava = fileName.right(5)==".java";
insideCS = fileName.right(3)==".cs"; insideCS = fileName.right(3)==".cs";
insidePHP = fileName.right(4)==".php" || fileName.right(5)==".php4" || insidePHP = fileName.right(4)==".php" || fileName.right(5)==".php4" ||
...@@ -587,6 +589,7 @@ PHPKW ("require"|"require_once"|"include"|"include_once"|"echo")[^a-zA-Z0-9_;] ...@@ -587,6 +589,7 @@ PHPKW ("require"|"require_once"|"include"|"include_once"|"echo")[^a-zA-Z0-9_;]
%x ClassDocFuncExc %x ClassDocFuncExc
%x ClassDocDefine %x ClassDocDefine
%x ClassDocRelates %x ClassDocRelates
%x ClassDocRelatesAlso
%x ClassDocBrief %x ClassDocBrief
%x ClassDocOverload %x ClassDocOverload
%x ClassDefineArgs %x ClassDefineArgs
...@@ -1320,6 +1323,35 @@ PHPKW ("require"|"require_once"|"include"|"include_once"|"echo")[^a-zA-Z0-9_;] ...@@ -1320,6 +1323,35 @@ PHPKW ("require"|"require_once"|"include"|"include_once"|"echo")[^a-zA-Z0-9_;]
current->name = yytext; current->name = yytext;
else else
current->name += yytext; current->name += yytext;
if (current->name.left(7)=="static ")
{
current->stat = TRUE;
current->name= current->name.mid(7);
}
else if (current->name.left(7)=="inline ")
{
if (current->type.isEmpty())
{
current->type="inline";
}
else
{
current->type+="inline ";
}
current->name= current->name.mid(7);
}
else if (current->name.left(6)=="const ")
{
if (current->type.isEmpty())
{
current->type="const";
}
else
{
current->type+="const ";
}
current->name=current->name.mid(6);
}
} }
QCString tmp=yytext; QCString tmp=yytext;
if (nameIsOperator(tmp)) if (nameIsOperator(tmp))
...@@ -3617,6 +3649,19 @@ PHPKW ("require"|"require_once"|"include"|"include_once"|"echo")[^a-zA-Z0-9_;] ...@@ -3617,6 +3649,19 @@ PHPKW ("require"|"require_once"|"include"|"include_once"|"echo")[^a-zA-Z0-9_;]
} }
BEGIN( lastDocRelContext ); BEGIN( lastDocRelContext );
} }
<ClassDoc,Doc,JavaDoc>{B}*{CMD}"relate"[sd]"also"{B}* {
lastDocRelAlsoContext = YY_START;
BEGIN( ClassDocRelatesAlso );
}
<ClassDocRelatesAlso>({ID}"::")*{ID} {
current->relatesDup = TRUE;
current->relates = yytext;
if (current->mGrpId!=NOGROUP)
{
memberGroupRelates = yytext;
}
BEGIN( lastDocRelAlsoContext );
}
<NameSpaceDocArg1>{SCOPENAME} { <NameSpaceDocArg1>{SCOPENAME} {
current->name = yytext; current->name = yytext;
newDocState(); newDocState();
......
...@@ -19,116 +19,6 @@ ...@@ -19,116 +19,6 @@
#include "searchindex.h" #include "searchindex.h"
#include <qfile.h> #include <qfile.h>
#if 0
#include "suffixtree.h"
SearchIndex::SearchIndex() : refDict(10007), nameIndex(10007)
{
indexCount=1;
//indexTree = new IndexTree;
suffixTree = new SuffixTree;
}
SearchIndex::~SearchIndex()
{
//delete indexTree;
delete suffixTree;
}
void SearchIndex::addReference(const char *key,const char *ref)
{
DocRef *dr=new DocRef(indexCount,key,ref);
nameIndex.insert(indexCount,dr);
refList.append(dr);
refDict.insert(key,dr);
indexCount++;
}
bool SearchIndex::addWord(const char *key,const char *word,bool special)
{
DocRef *dr=0;
if (word && key && strlen(key)>0 && (dr=refDict[key]))
{
suffixTree->insertWord(((QCString)word).lower(),dr->index(),special);
return TRUE;
}
else if (word)
{
printf("SearchIndex::addWord() key `%s' not found!\n",key);
return FALSE;
}
else
{
printf("SearchIndex::addWord() trying to insert word with length 0\n");
return FALSE;
}
}
bool SearchIndex::saveIndex(const char *fileName)
{
QFile f(fileName);
if (!f.open(IO_WriteOnly)) return FALSE;
// write header
if (f.writeBlock("DOXI",4)!=4) return FALSE; // write header
// compute forward offsets for all children of each node.
suffixTree->resolveForwardReferences();
// compute offset to the reference index table
int offset=suffixTree->size()+9;
// write the offset
if (writeNumber(f,offset)) return FALSE;
// write the suffix tree
if (!suffixTree->write(f)) return FALSE;
f.putch(0);
// write the index reference table
DocRef *dr=refList.first();
offset+=refList.count()*4;
while (dr)
{
writeNumber(f,offset);
offset+=strlen(dr->name())+strlen(dr->url())+2;
dr=refList.next();
}
// write the references
dr=refList.first();
while (dr)
{
writeString(f,dr->name());
writeString(f,dr->url());
dr=refList.next();
}
//printf("Building index tree\n");
printf("Size of the suffix tree is %d bytes\n",suffixTree->size());
printf("Number of tree nodes is %d\n",suffixTree->numberOfNodes());
printf("Number of links %d\n",indexCount);
//suffixTree->buildIndex();
//printf("Computing reference offsets\n");
//int offset=suffixTree->size()+8;
//indexTree->setOffsets(&nameIndex);
//printf("Saving suffix tree\n");
//printf("Saving index tree\n");
//result&=indexTree->write(f);
//printf("Saving reference list\n");
//dr=refList.first();
//while (dr)
//{
// result&=!writeString(f,dr->name());
// result&=!writeString(f,dr->url());
// dr=refList.next();
//}
//suffixTree->dump();
return TRUE;
}
#endif
// file format: // file format:
// 4 byte header // 4 byte header
......
...@@ -109,13 +109,15 @@ class SDict ...@@ -109,13 +109,15 @@ class SDict
m_dict = new QDict<T>(size); m_dict = new QDict<T>(size);
#endif #endif
} }
/*! Destroys the dictionary */ /*! Destroys the dictionary */
virtual ~SDict() virtual ~SDict()
{ {
delete m_list; delete m_list;
delete m_dict; delete m_dict;
} }
/*! Appends a compound to the dictionary. The element is owned by the
/*! Appends an element to the dictionary. The element is owned by the
* dictionary. * dictionary.
* \param key The unique key to use to quicky find the item later on. * \param key The unique key to use to quicky find the item later on.
* \param d The compound to add. * \param d The compound to add.
...@@ -132,12 +134,32 @@ class SDict ...@@ -132,12 +134,32 @@ class SDict
} }
#endif #endif
} }
/*! Prepends an element to the dictionary. The element is owned by the
* dictionary.
* \param key The unique key to use to quicky find the item later on.
* \param d The compound to add.
* \sa find()
*/
void prepend(const char *key,const T *d)
{
m_list->prepend(d);
m_dict->insert(key,d);
#if AUTORESIZE
if (m_dict->size()>SDict_primes[m_sizeIndex])
{
m_dict->resize(SDict_primes[++m_sizeIndex]);
}
#endif
}
/*! Remove an item from the dictionary */ /*! Remove an item from the dictionary */
bool remove(const char *key) bool remove(const char *key)
{ {
T *item = m_dict->take(key); T *item = m_dict->take(key);
return item ? m_list->remove(item) : FALSE; return item ? m_list->remove(item) : FALSE;
} }
/*! Sorts the members of the dictionary. First appending a number /*! Sorts the members of the dictionary. First appending a number
* of members and then sorting them is faster (O(NlogN) than using * of members and then sorting them is faster (O(NlogN) than using
* inSort() for each member (O(N^2)). * inSort() for each member (O(N^2)).
...@@ -162,11 +184,13 @@ class SDict ...@@ -162,11 +184,13 @@ class SDict
} }
#endif #endif
} }
/*! Indicates whether or not the dictionary owns its elements */ /*! Indicates whether or not the dictionary owns its elements */
void setAutoDelete(bool val) void setAutoDelete(bool val)
{ {
m_list->setAutoDelete(val); m_list->setAutoDelete(val);
} }
/*! Looks up a compound given its key. /*! Looks up a compound given its key.
* \param key The key to identify this element. * \param key The key to identify this element.
* \return The requested compound or zero if it cannot be found. * \return The requested compound or zero if it cannot be found.
...@@ -188,6 +212,7 @@ class SDict ...@@ -188,6 +212,7 @@ class SDict
{ {
return m_list->at(i); return m_list->at(i);
} }
/*! Function that is used to compare two items when sorting. /*! Function that is used to compare two items when sorting.
* Overload this to properly sort items. * Overload this to properly sort items.
* \sa inSort() * \sa inSort()
...@@ -196,6 +221,7 @@ class SDict ...@@ -196,6 +221,7 @@ class SDict
{ {
return item1!=item2; return item1!=item2;
} }
/*! Clears the dictionary. Will delete items if setAutoDelete() was /*! Clears the dictionary. Will delete items if setAutoDelete() was
* set to \c TRUE. * set to \c TRUE.
* \sa setAutoDelete * \sa setAutoDelete
...@@ -205,6 +231,7 @@ class SDict ...@@ -205,6 +231,7 @@ class SDict
m_list->clear(); m_list->clear();
m_dict->clear(); m_dict->clear();
} }
/*! Returns the number of items stored in the dictionary /*! Returns the number of items stored in the dictionary
*/ */
int count() int count()
...@@ -225,11 +252,13 @@ class SDict ...@@ -225,11 +252,13 @@ class SDict
{ {
m_li = new QListIterator<T>(*dict.m_list); m_li = new QListIterator<T>(*dict.m_list);
} }
/*! Destroys the dictionary */ /*! Destroys the dictionary */
virtual ~Iterator() virtual ~Iterator()
{ {
delete m_li; delete m_li;
} }
/*! Set the iterator to the first element in the list. /*! Set the iterator to the first element in the list.
* \return The first compound, or zero if the list was empty. * \return The first compound, or zero if the list was empty.
*/ */
...@@ -237,6 +266,7 @@ class SDict ...@@ -237,6 +266,7 @@ class SDict
{ {
return m_li->toFirst(); return m_li->toFirst();
} }
/*! Set the iterator to the last element in the list. /*! Set the iterator to the last element in the list.
* \return The first compound, or zero if the list was empty. * \return The first compound, or zero if the list was empty.
*/ */
...@@ -244,11 +274,13 @@ class SDict ...@@ -244,11 +274,13 @@ class SDict
{ {
return m_li->toLast(); return m_li->toLast();
} }
/*! Returns the current compound */ /*! Returns the current compound */
T *current() const T *current() const
{ {
return m_li->current(); return m_li->current();
} }
/*! Moves the iterator to the next element. /*! Moves the iterator to the next element.
* \return the new "current" element, or zero if the iterator was * \return the new "current" element, or zero if the iterator was
* already pointing at the last element. * already pointing at the last element.
...@@ -257,6 +289,7 @@ class SDict ...@@ -257,6 +289,7 @@ class SDict
{ {
return m_li->operator++(); return m_li->operator++();
} }
/*! Moves the iterator to the previous element. /*! Moves the iterator to the previous element.
* \return the new "current" element, or zero if the iterator was * \return the new "current" element, or zero if the iterator was
* already pointing at the first element. * already pointing at the first element.
...@@ -315,12 +348,14 @@ class SIntDict ...@@ -315,12 +348,14 @@ class SIntDict
m_dict = new QIntDict<T>(size); m_dict = new QIntDict<T>(size);
#endif #endif
} }
/*! Destroys the dictionary */ /*! Destroys the dictionary */
virtual ~SIntDict() virtual ~SIntDict()
{ {
delete m_list; delete m_list;
delete m_dict; delete m_dict;
} }
/*! Appends a compound to the dictionary. The element is owned by the /*! Appends a compound to the dictionary. The element is owned by the
* dictionary. * dictionary.
* \param key The unique key to use to quicky find the item later on. * \param key The unique key to use to quicky find the item later on.
...@@ -338,12 +373,32 @@ class SIntDict ...@@ -338,12 +373,32 @@ class SIntDict
} }
#endif #endif
} }
/*! Prepend a compound to the dictionary. The element is owned by the
* dictionary.
* \param key The unique key to use to quicky find the item later on.
* \param d The compound to add.
* \sa find()
*/
void prepend(int key,const T *d)
{
m_list->prepend(d);
m_dict->insert(key,d);
#if AUTORESIZE
if (m_dict->size()>SDict_primes[m_sizeIndex])
{
m_dict->resize(SDict_primes[++m_sizeIndex]);
}
#endif
}
/*! Remove an item from the dictionary */ /*! Remove an item from the dictionary */
bool remove(int key) bool remove(int key)
{ {
T *item = m_dict->take(key); T *item = m_dict->take(key);
return item ? m_list->remove(item) : FALSE; return item ? m_list->remove(item) : FALSE;
} }
/*! Sorts the members of the dictionary. First appending a number /*! Sorts the members of the dictionary. First appending a number
* of members and then sorting them is faster (O(NlogN) than using * of members and then sorting them is faster (O(NlogN) than using
* inSort() for each member (O(N^2)). * inSort() for each member (O(N^2)).
...@@ -352,6 +407,7 @@ class SIntDict ...@@ -352,6 +407,7 @@ class SIntDict
{ {
m_list->sort(); m_list->sort();
} }
/*! Inserts a compound into the dictionary in a sorted way. /*! Inserts a compound into the dictionary in a sorted way.
* \param key The unique key to use to quicky find the item later on. * \param key The unique key to use to quicky find the item later on.
* \param d The compound to add. * \param d The compound to add.
...@@ -368,11 +424,13 @@ class SIntDict ...@@ -368,11 +424,13 @@ class SIntDict
} }
#endif #endif
} }
/*! Indicates whether or not the dictionary owns its elements */ /*! Indicates whether or not the dictionary owns its elements */
void setAutoDelete(bool val) void setAutoDelete(bool val)
{ {
m_list->setAutoDelete(val); m_list->setAutoDelete(val);
} }
/*! Looks up a compound given its key. /*! Looks up a compound given its key.
* \param key The key to identify this element. * \param key The key to identify this element.
* \return The requested compound or zero if it cannot be found. * \return The requested compound or zero if it cannot be found.
...@@ -394,6 +452,7 @@ class SIntDict ...@@ -394,6 +452,7 @@ class SIntDict
{ {
return m_list->at(i); return m_list->at(i);
} }
/*! Function that is used to compare two items when sorting. /*! Function that is used to compare two items when sorting.
* Overload this to properly sort items. * Overload this to properly sort items.
* \sa inSort() * \sa inSort()
...@@ -402,6 +461,7 @@ class SIntDict ...@@ -402,6 +461,7 @@ class SIntDict
{ {
return item1!=item2; return item1!=item2;
} }
/*! Clears the dictionary. Will delete items if setAutoDelete() was /*! Clears the dictionary. Will delete items if setAutoDelete() was
* set to \c TRUE. * set to \c TRUE.
* \sa setAutoDelete * \sa setAutoDelete
...@@ -411,6 +471,7 @@ class SIntDict ...@@ -411,6 +471,7 @@ class SIntDict
m_list->clear(); m_list->clear();
m_dict->clear(); m_dict->clear();
} }
/*! Returns the number of items stored in the dictionary /*! Returns the number of items stored in the dictionary
*/ */
int count() int count()
...@@ -431,11 +492,13 @@ class SIntDict ...@@ -431,11 +492,13 @@ class SIntDict
{ {
m_li = new QListIterator<T>(*dict.m_list); m_li = new QListIterator<T>(*dict.m_list);
} }
/*! Destroys the dictionary */ /*! Destroys the dictionary */
virtual ~Iterator() virtual ~Iterator()
{ {
delete m_li; delete m_li;
} }
/*! Set the iterator to the first element in the list. /*! Set the iterator to the first element in the list.
* \return The first compound, or zero if the list was empty. * \return The first compound, or zero if the list was empty.
*/ */
...@@ -443,6 +506,7 @@ class SIntDict ...@@ -443,6 +506,7 @@ class SIntDict
{ {
return m_li->toFirst(); return m_li->toFirst();
} }
/*! Set the iterator to the last element in the list. /*! Set the iterator to the last element in the list.
* \return The first compound, or zero if the list was empty. * \return The first compound, or zero if the list was empty.
*/ */
...@@ -450,11 +514,13 @@ class SIntDict ...@@ -450,11 +514,13 @@ class SIntDict
{ {
return m_li->toLast(); return m_li->toLast();
} }
/*! Returns the current compound */ /*! Returns the current compound */
T *current() const T *current() const
{ {
return m_li->current(); return m_li->current();
} }
/*! Moves the iterator to the next element. /*! Moves the iterator to the next element.
* \return the new "current" element, or zero if the iterator was * \return the new "current" element, or zero if the iterator was
* already pointing at the last element. * already pointing at the last element.
...@@ -463,6 +529,7 @@ class SIntDict ...@@ -463,6 +529,7 @@ class SIntDict
{ {
return m_li->operator++(); return m_li->operator++();
} }
/*! Moves the iterator to the previous element. /*! Moves the iterator to the previous element.
* \return the new "current" element, or zero if the iterator was * \return the new "current" element, or zero if the iterator was
* already pointing at the first element. * already pointing at the first element.
......
...@@ -116,28 +116,16 @@ ...@@ -116,28 +116,16 @@
// - The trReimplementedInList() updated to fit the context better. // - The trReimplementedInList() updated to fit the context better.
// - The trReimplementedFromList() updated to fit the context better. // - The trReimplementedFromList() updated to fit the context better.
// //
// 2001/07/16 // 2001/07/16 - trClassDocumentation() updated as in the English translator.
// - trClassDocumentation() updated as in the English translator. // 2001/11/06 - trReferences() implemented.
// // 2002/01/23 - Two new methods "since 1.2.13" implemented.
// 2001/11/06 // 2002/03/05 - ... forgot to replace TranslatorAdapter... by Translator.
// - trReferences() implemented. // 2002/07/08 (my birthday! ;) - The new trRTFTableOfContents() implemented.
// // 2002/07/29 - The new trDeprecatedList() implemented.
// 2002/01/23
// - trImplementedFromList() and trImplementedInList() implemented
// (new since 1.2.13)
//
// 2002/03/05
// - ... forgot to replace TranslatorAdapter... base class by Translator.
//
// 2002/07/08 (my birthday! ;)
// - The new trRTFTableOfContents() implemented.
//
// 2002/07/29
// - The new trDeprecatedList() implemented.
//
// 2002/10/15 - The new trEvents() and trEventDocumentation() implemented. // 2002/10/15 - The new trEvents() and trEventDocumentation() implemented.
// 2003/04/28 - Five new methods "since 1.3" implemented. // 2003/04/28 - Five new methods "since 1.3" implemented.
// 2003/06/10 - Two new methods "since 1.3.1" implemented. // 2003/06/10 - Two new methods "since 1.3.1" implemented.
// 2003/08/13 - Four new "since 1.3.3" implemented.
// Todo // Todo
// ---- // ----
...@@ -157,7 +145,7 @@ ...@@ -157,7 +145,7 @@
// Windows version. The version which does not call the function is // Windows version. The version which does not call the function is
// probably slightly faster. // probably slightly faster.
class TranslatorCzech : public TranslatorAdapter_1_3_3 class TranslatorCzech : public Translator
{ {
private: private:
/*! The decode() inline assumes the source written in the /*! The decode() inline assumes the source written in the
...@@ -1608,6 +1596,56 @@ class TranslatorCzech : public TranslatorAdapter_1_3_3 ...@@ -1608,6 +1596,56 @@ class TranslatorCzech : public TranslatorAdapter_1_3_3
return decode("Graf volání této funkce:"); return decode("Graf volání této funkce:");
} }
//////////////////////////////////////////////////////////////////////////
// new since 1.3.3
//////////////////////////////////////////////////////////////////////////
/*! When the search engine is enabled this text is put in the index
* of each page before the search field.
*/
virtual QCString trSearchForIndex()
{
return decode("Vyhledat");
}
/*! This string is used as the title for the page listing the search
* results.
*/
virtual QCString trSearchResultsTitle()
{
return decode("Výsledky vyhledávání");
}
/*! This string is put just before listing the search results. The
* text can be different depending on the number of documents found.
* Inside the text you can put the special marker $num to insert
* the number representing the actual number of search results.
* The @a numDocuments parameter can be either 0, 1 or 2, where the
* value 2 represents 2 or more matches. HTML markup is allowed inside
* the returned string.
*/
virtual QCString trSearchResults(int numDocuments)
{
if (numDocuments==0)
{
return decode("Lituji. Vašemu dotazu neodpovídá žádný dokument.");
}
else if (numDocuments==1)
{
return decode("Nalezen jediný dokument, který vyhovuje vašemu dotazu.");
}
else
{
return decode("Nalezeno <b>$num</b> dokumentù, které vyhovují vašemu "
"dotazu. Nejlépe odpovídající dokumenty jsou zobrazeny "
"jako první.");
}
}
/*! This string is put before the list of matched words, for each search
* result. What follows is the list of words that matched the query.
*/
virtual QCString trSearchMatches()
{
return decode("Nalezená slova:");
}
}; };
#endif // TRANSLATOR_CZ_H #endif // TRANSLATOR_CZ_H
...@@ -1493,8 +1493,9 @@ class TranslatorEnglish : public Translator ...@@ -1493,8 +1493,9 @@ class TranslatorEnglish : public Translator
// new since 1.3.3 // new since 1.3.3
////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////
/*! When the search engine is enabled this text is put in the index /*! When the search engine is enabled this text is put in the header
* of each page before the search field. * of each page before the field where one can enter the text to search
* for.
*/ */
virtual QCString trSearchForIndex() virtual QCString trSearchForIndex()
{ {
......
...@@ -25,7 +25,7 @@ ...@@ -25,7 +25,7 @@
#ifndef TRANSLATOR_ES_H #ifndef TRANSLATOR_ES_H
#define TRANSLATOR_ES_H #define TRANSLATOR_ES_H
class TranslatorSpanish : public TranslatorAdapter_1_2_7 class TranslatorSpanish : public TranslatorAdapter_1_3_3
{ {
public: public:
virtual QCString idLanguage() virtual QCString idLanguage()
...@@ -355,9 +355,14 @@ class TranslatorSpanish : public TranslatorAdapter_1_2_7 ...@@ -355,9 +355,14 @@ class TranslatorSpanish : public TranslatorAdapter_1_2_7
virtual QCString trEnumerationValues() virtual QCString trEnumerationValues()
{ return "Valores de la enumeración"; } { return "Valores de la enumeración"; }
/*! This is used in man pages as the author section. */ /*! This text is generated when the \\author command is used and
virtual QCString trAuthor() * for the author section in man pages. */
{ return "Autor"; } virtual QCString trAuthor(bool first_capital, bool singular)
{
QCString result((first_capital ? "Author" : "author"));
if (!singular) result+="s";
return result;
}
/*! This is used in the documentation of a file before the list of /*! This is used in the documentation of a file before the list of
* documentation blocks for defines * documentation blocks for defines
...@@ -1222,6 +1227,121 @@ class TranslatorSpanish : public TranslatorAdapter_1_2_7 ...@@ -1222,6 +1227,121 @@ class TranslatorSpanish : public TranslatorAdapter_1_2_7
return result; return result;
} }
/*! This text is put before the list of members referenced by a member
*/
virtual QCString trReferences()
{
return "Hace referencia a";
}
/*! used in member documentation blocks to produce a list of
* members that are implemented by this one.
*/
virtual QCString trImplementedFromList(int numEntries)
{
return "Implementa "+trWriteList(numEntries)+".";
}
/*! used in member documentation blocks to produce a list of
* all members that implement this abstract member.
*/
virtual QCString trImplementedInList(int numEntries)
{
return "Implementado en "+trWriteList(numEntries)+".";
}
/*! used in RTF documentation as a heading for the Table
* of Contents.
*/
virtual QCString trRTFTableOfContents()
{
return "Tabla de Contenidos";
}
/*! Used as the header of the list of item that have been
* flagged deprecated
*/
virtual QCString trDeprecatedList()
{
return "Lista de Desaprobados";
}
/*! Used as a header for declaration section of the events found in
* a C# program
*/
virtual QCString trEvents()
{
return "Eventos";
}
/*! Header used for the documentation section of a class' events. */
virtual QCString trEventDocumentation()
{
return "Documentación de los Eventos";
}
/*! Used as a heading for a list of Java class types with package scope.
*/
virtual QCString trPackageTypes()
{
return "Tipos del Paquete";
}
/*! Used as a heading for a list of Java class functions with package
* scope.
*/
virtual QCString trPackageMembers()
{
return "Funciones del Paquete";
}
/*! Used as a heading for a list of static Java class functions with
* package scope.
*/
virtual QCString trStaticPackageMembers()
{
return "Funciones Estáticas del Paquete";
}
/*! Used as a heading for a list of Java class variables with package
* scope.
*/
virtual QCString trPackageAttribs()
{
return "Atributos del Paquete";
}
/*! Used as a heading for a list of static Java class variables with
* package scope.
*/
virtual QCString trStaticPackageAttribs()
{
return "Atributos Estáticos del Paquete";
}
//////////////////////////////////////////////////////////////////////////
// new since 1.3.1
//////////////////////////////////////////////////////////////////////////
/*! Used in the quick index of a class/file/namespace member list page
* to link to the unfiltered list of all members.
*/
virtual QCString trAll()
{
return "Todo";
}
/*! Put in front of the call graph for a function. */
virtual QCString trCallGraph()
{
return "Gráfico de llamadas para esta función:";
}
//////////////////////////////////////////////////////////////////////////
// new since 1.3.3
//////////////////////////////////////////////////////////////////////////
}; };
......
...@@ -399,7 +399,8 @@ int guessSection(const char *name) ...@@ -399,7 +399,8 @@ int guessSection(const char *name)
n.right(4)==".hxx" || n.right(4)==".hxx" ||
n.right(4)==".hpp" || n.right(4)==".hpp" ||
n.right(4)==".h++" || n.right(4)==".h++" ||
n.right(4)==".idl" n.right(4)==".idl" ||
n.right(5)==".pidl"
) return Entry::HEADER_SEC; ) return Entry::HEADER_SEC;
return 0; return 0;
} }
...@@ -542,180 +543,615 @@ NamespaceDef *getResolvedNamespace(const char *name) ...@@ -542,180 +543,615 @@ NamespaceDef *getResolvedNamespace(const char *name)
} }
} }
static QDict<Definition> g_resolvedScopes; //static QDict<Definition> g_resolvedScopes;
//
///*
// * find the fully qualified class name refered to by the input class
// * or typedef name against the input scope.
// * loops through scope and each of its parent scopes looking for a
// * match against the input name. Also recursively calls itself to check
// * against any imported namespaces in each scope being checked.
// */
//ClassDef *getResolvedClassRecursive(
// Definition *scope,
// const char *n,
// bool *pIsTypeDef,
// QCString *pTemplSpec
// )
//{
// QCString name = n;
// // bail out if there is no name
// if (name.isEmpty()) return 0;
// // use the global scope if no scope was passed
// if (scope==0) scope=Doxygen::globalScope;
// ClassDef *cd=0;
//
// //printf("===================\n");
// Definition *typedefScope = 0;
// //printf("-----------------------------------------------------\n");
// QCString subst = resolveTypeDef(scope,name,&typedefScope);
// //printf("trying getResolvedClass(%s,%s) => subst=%s\n",
// // scope ? scope->name().data() : "<none>", name.data(),subst.data());
//
// if (!subst.isEmpty())
// {
// //printf(" typedef value=%s typedefScope=%s\n",subst.data(),
// // typedefScope?typedefScope->qualifiedName().data():0);
//
// // strip * and & from n
// int ip=subst.length()-1;
// while (ip>=0 && (subst.at(ip)=='*' || subst.at(ip)=='&' ||
// subst.at(ip)==' ')) ip--;
// subst=subst.left(ip+1);
//
// if (pIsTypeDef) *pIsTypeDef=TRUE;
// if (subst==name) // avoid resolving "typedef struct foo foo";
// {
// cd = Doxygen::classSDict.find(name);
// if (cd) goto found;
// }
// else
// {
// int count=0; // recursion detection guard
// QCString newSubst;
// QCString typeName = subst;
// //printf( "---> subst=%s\n",subst.data());
//
// while (!(newSubst=resolveTypeDef(typedefScope,typeName)).isEmpty()
// && count<10)
// {
// //printf( "---> newSubst=%s\n",newSubst.data());
// if (typeName==newSubst)
// {
// cd = Doxygen::classSDict.find(subst); // for breaking typedef struct A A;
// //printf(" getClass: exit `%s' %p\n",subst.data(),cd);
// if (cd) goto found;
// break;
// }
// subst=newSubst;
// // strip * and & from n
// int ip=subst.length()-1;
// while (ip>=0 && subst.at(ip)=='*' || subst.at(ip)=='&' || subst.at(ip)==' ') ip--;
// subst=subst.left(ip+1);
// //printf(" getResolvedClass `%s'->`%s'\n",name.data(),subst.data());
//
// typeName=newSubst;
// //if (index!=-1) typeName.prepend(name.left(index)+"::");
// count++;
// }
// if (count==10)
// {
// warn_cont("Warning: possible recursive typedef dependency detected for %s!\n",n);
// cd = Doxygen::classSDict.find(name);
// if (cd) goto found;
// }
// else
// {
// int i;
// if (typedefScope)
// {
// cd = Doxygen::classSDict.find(typedefScope->qualifiedName()+"::"+typeName);
// }
// if (cd==0)
// {
// cd = Doxygen::classSDict.find(typeName);
// }
// //printf(" getClass: subst %s->%s cd=%p\n",name.data(),typeName.data(),cd);
// if (cd==0 && (i=typeName.find('<'))>0) // try unspecialized version as well
// {
// if (pTemplSpec) *pTemplSpec = typeName.right(typeName.length()-i);
// cd = Doxygen::classSDict.find(typeName.left(i));
// }
// //if (cd) goto found;
// }
// }
// // whether we found something or not, we stop searching to prevent
// // finding false positives.
// goto found;
// }
// else // not a typedef
// {
// do
// {
// //printf(" %s is not a typedef value in scope %s\n",name.data(),scope?scope->name().data():"<global>");
// if (pIsTypeDef) *pIsTypeDef=FALSE;
// if (scope!=Doxygen::globalScope)
// {
// cd = Doxygen::classSDict.find(scope->name()+"::"+name);
// }
// else
// {
// cd = Doxygen::classSDict.find(name);
// }
// if (cd==0)
// {
// if (scope->definitionType()==Definition::TypeNamespace)
// {
// NamespaceDef *nscope = (NamespaceDef*)scope;
// ClassSDict *cl = nscope->getUsedClasses();
// if (cl) // see if the class was imported via a using statement
// {
// ClassSDict::Iterator cli(*cl);
// ClassDef *ucd;
// for (cli.toFirst();(ucd=cli.current());++cli)
// {
// //printf("comparing %s<->%s\n",ucd->name().data(),name.data());
// if (rightScopeMatch(ucd->name(),name))
// {
// cd=ucd;
// break;
// }
// }
// }
// NamespaceSDict *nl = nscope->getUsedNamespaces();
// if (nl) // check used namespaces for the class
// {
// NamespaceSDict::Iterator nli(*nl);
// NamespaceDef *und;
// for (nli.toFirst();(und=nli.current());++nli)
// {
// if (g_resolvedScopes.find(und->name())==0)
// {
// g_resolvedScopes.insert(und->name(),und);
// cd = getResolvedClassRecursive(und,name,pIsTypeDef,pTemplSpec);
// g_resolvedScopes.remove(und->name());
// if (cd) break;
// }
// }
// }
// }
// }
// if (cd) goto found;
//
// if (scope==Doxygen::globalScope) scope=0;
// else if (scope) scope=scope->getOuterScope();
// //fprintf(stderr,"scope=%p\n",scope);
// } while (scope);
// }
//
//found:
// //printf("getResolvedClass()=%s\n",cd?cd->name().data():"<none>");
// return cd;
//}
//
//
//ClassDef *getOldResolvedClass(
// Definition *scope,
// const char *n,
// bool *pIsTypeDef,
// QCString *pTemplSpec
// )
//{
// g_resolvedScopes.clear();
// return getResolvedClassRecursive(scope,n,pIsTypeDef,pTemplSpec);
//}
//
//-------------------------------------------------------------------------
//-------------------------------------------------------------------------
//-------------------------------------------------------------------------
//-------------------------------------------------------------------------
static QDict<MemberDef> g_resolvedTypedefs;
ClassDef *getResolvedClassRecursive( // forward declaration
Definition *scope, ClassDef *getResolvedClassRec(Definition *scope,
FileDef *fileScope,
const char *n, const char *n,
bool *pIsTypeDef, bool *pIsTypeDef,
QCString *pTemplSpec QCString *pTemplSpec
) );
{ int isAccessibleFrom(Definition *scope,FileDef *fileScope,Definition *item,
QCString name = n; const QCString &explicitScopePart);
if (scope==0) scope=Doxygen::globalScope;
if (name.isEmpty()) return 0;
ClassDef *cd=0;
//printf("===================\n"); /*! Returns the class representing the value of the typedef represented by md.
do *
* Example: typedef A T; will return the class representing A if it is a class.
*
* Example: typedef int T; will return 0, since "int" is not a class.
*/
ClassDef *newResolveTypedef(FileDef *fileScope,MemberDef *md,QCString *pTemplSpec)
{
bool isCached = md->isTypedefValCached(); // value already cached
if (isCached)
{ {
Definition *typedefScope = 0; return md->getCachedTypedefVal();
//printf("-----------------------------------------------------\n"); }
QCString subst = resolveTypeDef(scope,name,&typedefScope); QCString qname = md->qualifiedName();
//printf("trying getResolvedClass(%s,%s) => subst=%s\n", if (g_resolvedTypedefs.find(qname)) return 0; // typedef already done
// scope ? scope->name().data() : "<none>", name.data(),subst.data());
g_resolvedTypedefs.insert(qname,md); // put on the trace list
if (!subst.isEmpty()) QCString type = md->typeString(); // get the "value" of the typedef
int ip=type.length()-1; // remove * and & at the end
while (ip>=0 && (type.at(ip)=='*' || type.at(ip)=='&' || type.at(ip)==' '))
{
ip--;
}
type=type.left(ip+1);
if (type.left(6)=="const ") // strip leading "const"
{
type=type.mid(6);
}
if (type.left(7)=="struct ") // strip leading "struct"
{ {
//printf(" typedef value=%s typedefScope=%s\n",subst.data(), }
// typedefScope?typedefScope->qualifiedName().data():0); else if (type.left(6)=="union ") // or strip leading "union"
{
}
type=type.stripWhiteSpace(); // strip leading and trailing whitespace
ClassDef *result = getResolvedClassRec(md->getOuterScope(),fileScope,type,0,0);
if (result==0)
{
// try unspecialized version if type is template
int i=type.find('<');
if (i!=-1) // typedef of a template => try the unspecialized version
{
*pTemplSpec = type.mid(i);
result = getResolvedClassRec(md->getOuterScope(),fileScope,type.left(i),0,0);
}
}
// remember computed value for next time
md->cacheTypedefVal(result);
g_resolvedTypedefs.remove(qname); // remove from the trace list
return result;
}
/*! Substitutes a simple unqualified \a name within \a scope. Returns the
* value of the typedef or \a name if no typedef was found.
*/
QCString substTypedef(Definition *scope,FileDef *fileScope,const QCString &name)
{
QCString result=name;
if (name.isEmpty()) return result;
// strip * and & from n // lookup scope fragment in the symbol map
int ip=subst.length()-1; DefinitionList *dl = Doxygen::symbolMap->find(name);
while (ip>=0 && (subst.at(ip)=='*' || subst.at(ip)=='&' || if (dl==0) return result; // no matches
subst.at(ip)==' ')) ip--;
subst=subst.left(ip+1);
if (pIsTypeDef) *pIsTypeDef=TRUE; // search for the best match
if (subst==name) // avoid resolving "typedef struct foo foo"; DefinitionListIterator dli(*dl);
Definition *d;
int minDistance=10000; // init at "infinite"
MemberDef *bestMatch=0;
for (dli.toFirst();(d=dli.current());++dli) // foreach definition
{ {
cd = Doxygen::classSDict.find(name); // only look at members
if (cd) goto found; if (d->definitionType()==Definition::TypeMember)
}
else
{ {
int count=0; // recursion detection guard // that are also typedefs
QCString newSubst; MemberDef *md = (MemberDef *)d;
QCString typeName = subst; if (md->isTypedef()) // d is a typedef
//printf( "---> subst=%s\n",subst.data()); {
// test accessibility of typedef within scope.
int distance = isAccessibleFrom(scope,fileScope,d,"");
if (distance!=-1 && distance<minDistance)
// definition is accessible and a better match
{
minDistance=distance;
bestMatch = md;
}
}
}
}
if (bestMatch) result = bestMatch->typeString();
//printf("substTypedef(%s,%s)=%s\n",scope?scope->name().data():"<global>",
// name.data(),result.data());
return result;
}
while (!(newSubst=resolveTypeDef(typedefScope,typeName)).isEmpty() /*! Starting with scope \a start, the string \a path is interpreted as
&& count<10) * a part of a qualified scope name (e.g. A::B::C), and the scope is
* searched. If found the scope definition is returned, otherwise 0
* is returned.
*/
static Definition *followPath(Definition *start,FileDef *fileScope,const QCString &path)
{
int is,ps=0;
int l;
Definition *current=start;
// for each part of the explicit scope
while ((is=getScopeFragment(path,ps,&l))!=-1)
{
// try to resolve the part if it is a typedef
QCString qualScopePart = substTypedef(current,fileScope,path.mid(is,l));
current = current->findInnerCompound(qualScopePart);
if (current==0) break; // failed to follow the path
ps=is+l;
}
return current; // path could be followed
}
bool accessibleViaUsingClass(const ClassSDict *cl,FileDef *fileScope,Definition *item,const QCString &explicitScopePart="")
{
if (cl) // see if the class was imported via a using statement
{ {
//printf( "---> newSubst=%s\n",newSubst.data()); ClassSDict::Iterator cli(*cl);
if (typeName==newSubst) ClassDef *ucd;
for (cli.toFirst();(ucd=cli.current());++cli)
{ {
cd = Doxygen::classSDict.find(subst); // for breaking typedef struct A A; Definition *sc = explicitScopePart.isEmpty() ? ucd : followPath(ucd,fileScope,explicitScopePart);
//printf(" getClass: exit `%s' %p\n",subst.data(),cd); if (item->definitionType()==Definition::TypeMember)
if (cd) goto found; {
break; MemberDef *md = (MemberDef *)item;
if (md->isTypedef()) // d is a typedef
{
QCString spec;
ClassDef *typedefClass = newResolveTypedef(fileScope,md,&spec);
if (sc && sc==typedefClass) return TRUE;
} }
subst=newSubst;
// strip * and & from n
int ip=subst.length()-1;
while (ip>=0 && subst.at(ip)=='*' || subst.at(ip)=='&' || subst.at(ip)==' ') ip--;
subst=subst.left(ip+1);
//printf(" getResolvedClass `%s'->`%s'\n",name.data(),subst.data());
typeName=newSubst;
//if (index!=-1) typeName.prepend(name.left(index)+"::");
count++;
} }
if (count==10) else // item is a class
{ {
warn_cont("Warning: possible recursive typedef dependency detected for %s!\n",n); if (sc && sc==item) return TRUE;
cd = Doxygen::classSDict.find(name);
if (cd) goto found;
} }
else }
}
return FALSE;
}
bool accessibleViaUsingNamespace(const NamespaceSDict *nl,FileDef *fileScope,Definition *item,const QCString &explicitScopePart="")
{
if (nl) // check used namespaces for the class
{ {
int i; NamespaceSDict::Iterator nli(*nl);
if (typedefScope) NamespaceDef *und;
for (nli.toFirst();(und=nli.current());++nli)
{ {
cd = Doxygen::classSDict.find(typedefScope->qualifiedName()+"::"+typeName); Definition *sc = explicitScopePart.isEmpty() ? und : followPath(und,fileScope,explicitScopePart);
if (sc && item->getOuterScope()==sc) return TRUE;
}
} }
if (cd==0) return FALSE;
}
/* Returns the "distance" (=number of levels up) from item to scope, or -1
* if item in not inside scope.
*/
int isAccessibleFrom(Definition *scope,FileDef *fileScope,Definition *item)
{
//printf("<isAccesibleFrom(%s,%s)\n",scope?scope->name().data():"<global>",
// item?item->name().data():"<none>");
if (item->getOuterScope()==scope)
{ {
cd = Doxygen::classSDict.find(typeName); //printf("> found it\n");
return 0; // found it
} }
//printf(" getClass: subst %s->%s cd=%p\n",name.data(),typeName.data(),cd); else if (scope==Doxygen::globalScope)
if (cd==0 && (i=typeName.find('<'))>0) // try unspecialized version as well {
if (fileScope)
{ {
if (pTemplSpec) *pTemplSpec = typeName.right(typeName.length()-i); ClassSDict *cl = fileScope->getUsedClasses();
cd = Doxygen::classSDict.find(typeName.left(i)); if (accessibleViaUsingClass(cl,fileScope,item)) return 0;
NamespaceSDict *nl = fileScope->getUsedNamespaces();
if (accessibleViaUsingNamespace(nl,fileScope,item)) return 0;
}
return -1; // not found in path to globalScope
//printf("> reached global scope\n");
} }
//if (cd) goto found; else // keep searching
{
// check if scope is a namespace, which is using other classes and namespaces
if (scope->definitionType()==Definition::TypeNamespace)
{
NamespaceDef *nscope = (NamespaceDef*)scope;
ClassSDict *cl = nscope->getUsedClasses();
if (accessibleViaUsingClass(cl,fileScope,item)) return 0;
NamespaceSDict *nl = nscope->getUsedNamespaces();
if (accessibleViaUsingNamespace(nl,fileScope,item)) return 0;
} }
// repeat for the parent scope
int i=isAccessibleFrom(scope->getOuterScope(),fileScope,item);
//printf("> continue\n");
return (i==-1) ? -1 : i+1;
} }
// whether we found something or not, we stop searching to prevent }
// finding false positives.
goto found;
/* Returns the "distance" (=number of levels up) from item to scope, or -1
* if item in not in this scope. The explicitScopePart limits the search
* to scopes that match \a scope plus the explicit part.
*/
int isAccessibleFrom(Definition *scope,FileDef *fileScope,Definition *item,
const QCString &explicitScopePart)
{
if (explicitScopePart.isEmpty())
{
// handle degenerate case where there is no explicit scope.
return isAccessibleFrom(scope,fileScope,item);
} }
else // not a typedef //printf("<isAccesibleFrom(%s,%s,%s)\n",scope?scope->name().data():"<global>",
// item?item->name().data():"<none>",
// explicitScopePart.data());
Definition *newScope = followPath(scope,fileScope,explicitScopePart);
if (newScope) // explicitScope is inside scope => newScope is the result
{ {
//printf(" %s is not a typedef value in scope %s\n",name.data(),scope?scope->name().data():"<global>"); //printf("scope traversal successful!\n");
if (pIsTypeDef) *pIsTypeDef=FALSE; if (item->getOuterScope()==newScope)
if (scope!=Doxygen::globalScope)
{ {
cd = Doxygen::classSDict.find(scope->name()+"::"+name); //printf("> found it\n");
return 0; // found it
} }
else else
{ {
cd = Doxygen::classSDict.find(name); // repeat for the parent scope
int i=-1;
if (scope!=Doxygen::globalScope)
{
i = isAccessibleFrom(scope->getOuterScope(),fileScope,item,explicitScopePart);
}
//printf("> continue\n");
return (i==-1) ? -1 : i+1;
}
} }
if (cd==0) else // failed to resolve explicitScope
{ {
//printf("failed to resolve: scope=%s\n",scope->name().data());
if (scope->definitionType()==Definition::TypeNamespace) if (scope->definitionType()==Definition::TypeNamespace)
{ {
NamespaceDef *nscope = (NamespaceDef*)scope; NamespaceDef *nscope = (NamespaceDef*)scope;
ClassList *cl = nscope->getUsedClasses(); ClassSDict *cl = nscope->getUsedClasses();
if (cl) // see if the class was imported via a using statement if (accessibleViaUsingClass(cl,fileScope,item,explicitScopePart)) return 0;
NamespaceSDict *nl = nscope->getUsedNamespaces();
if (accessibleViaUsingNamespace(nl,fileScope,item,explicitScopePart)) return 0;
}
if (scope==Doxygen::globalScope)
{ {
ClassListIterator cli(*cl); if (fileScope)
ClassDef *ucd;
for (cli.toFirst();(ucd=cli.current());++cli)
{ {
//printf("comparing %s<->%s\n",ucd->name().data(),name.data()); ClassSDict *cl = fileScope->getUsedClasses();
if (rightScopeMatch(ucd->name(),name)) if (accessibleViaUsingClass(cl,fileScope,item,explicitScopePart)) return 0;
NamespaceSDict *nl = fileScope->getUsedNamespaces();
if (accessibleViaUsingNamespace(nl,fileScope,item,explicitScopePart)) return 0;
}
//printf("> reached global scope\n");
return -1;
}
else // continue by looking into the parent scope
{ {
cd=ucd; int i=isAccessibleFrom(scope->getOuterScope(),fileScope,item,explicitScopePart);
break; //printf("> continue\n");
return (i==-1) ? -1 : i+1;
} }
} }
}
/* Find the fully qualified class name refered to by the input class
* or typedef name against the input scope.
* Loops through scope and each of its parent scopes looking for a
* match against the input name. Can recursively call itself when
* resolving typedefs.
*/
ClassDef *getResolvedClassRec(Definition *scope,
FileDef *fileScope,
const char *n,
bool *pIsTypeDef,
QCString *pTemplSpec
)
{
//printf("[getResolvedClassRec(%s,%s)\n",scope?scope->name().data():"<global>",n);
QCString name=n;
QCString explicitScopePart;
int qualifierIndex = name.findRev("::"); // todo: deal with cases like A<B::C>
if (qualifierIndex!=-1) // qualified name
{
// split off the explicit scope part
explicitScopePart=name.left(qualifierIndex);
// todo: improve namespace alias substitution
replaceNamespaceAliases(explicitScopePart,explicitScopePart.length());
name=name.mid(qualifierIndex+2);
} }
NamespaceList *nl = nscope->getUsedNamespaces(); if (name.isEmpty()) return 0; // empty name
if (nl) // check used namespaces for the class
DefinitionList *dl = Doxygen::symbolMap->find(name);
//printf("Looking for symbol %s result=%p\n",name.data(),dl);
if (dl==0) return 0; // symbol not found
//printf(" found %d symbol with name %s\n",dl->count(),name.data());
// now we look int the list of Definitions and determine which one is the "best"
DefinitionListIterator dli(*dl);
Definition *d;
ClassDef *bestMatch=0;
bool bestIsTypedef=FALSE;
QCString bestTemplSpec;
int minDistance=10000; // init at "infinite"
for (dli.toFirst();(d=dli.current());++dli) // foreach definition
{ {
NamespaceListIterator nli(*nl); //printf(" found type %x name=%s\n",d->definitionType(),d->name().data());
NamespaceDef *und; // only look at classes and members
for (nli.toFirst();(und=nli.current());++nli) if (d->definitionType()==Definition::TypeClass ||
d->definitionType()==Definition::TypeMember)
{
// test accessibility of definition within scope.
int distance = isAccessibleFrom(scope,fileScope,d,explicitScopePart);
if (distance!=-1) // definition is accessible
{
// see if we are dealing with a class or a typedef
if (d->definitionType()==Definition::TypeClass) // d is a class
{ {
if (g_resolvedScopes.find(und->name())==0) if (distance<minDistance) // found a definition that is "closer"
{ {
g_resolvedScopes.insert(und->name(),und); minDistance=distance;
cd = getResolvedClassRecursive(und,name,pIsTypeDef,pTemplSpec); bestMatch = (ClassDef *)d;
g_resolvedScopes.remove(und->name()); bestIsTypedef = FALSE;
if (cd) break; bestTemplSpec.resize(0);
} }
} }
else if (d->definitionType()==Definition::TypeMember)
{
MemberDef *md = (MemberDef *)d;
if (md->isTypedef()) // d is a typedef
{
QCString spec;
ClassDef *typedefClass = newResolveTypedef(fileScope,md,&spec);
// we found a symbol at this distance, but if it didn't
// resolve to a class, we still have to make sure that
// something at a greater distance does not match, since
// that symbol is hidden by this one.
if (distance<minDistance)
{
minDistance=distance;
bestMatch = typedefClass;
bestIsTypedef = TRUE;
bestTemplSpec = spec;
} }
} }
} }
if (cd) goto found; } // if definition accessible
} // if definition is a class or member
} // foreach definition
if (pIsTypeDef)
{
*pIsTypeDef = bestIsTypedef;
} }
if (pTemplSpec)
if (scope==Doxygen::globalScope) scope=0; {
else if (scope) scope=scope->getOuterScope(); *pTemplSpec = bestTemplSpec;
//fprintf(stderr,"scope=%p\n",scope); }
} while (scope); //printf("] bestMatch=%s\n",bestMatch?bestMatch->name().data():"<none>");
return bestMatch;
found:
//printf("getResolvedClass()=%s\n",cd?cd->name().data():"<none>");
return cd;
} }
/* Find the fully qualified class name refered to by the input class
ClassDef *getResolvedClass( * or typedef name against the input scope.
Definition *scope, * Loops through scope and each of its parent scopes looking for a
* match against the input name.
*/
ClassDef *getResolvedClass(Definition *scope,
FileDef *fileScope,
const char *n, const char *n,
bool *pIsTypeDef, bool *pIsTypeDef,
QCString *pTemplSpec QCString *pTemplSpec
) )
{ {
g_resolvedScopes.clear(); g_resolvedTypedefs.clear();
return getResolvedClassRecursive(scope,n,pIsTypeDef,pTemplSpec); if (scope==0 ||
(scope->definitionType()!=Definition::TypeClass &&
scope->definitionType()!=Definition::TypeNamespace
)
)
{
scope=Doxygen::globalScope;
}
ClassDef *result = getResolvedClassRec(scope,fileScope,n,pIsTypeDef,pTemplSpec);
if (result && !result->isLinkable()) result=0; // don't link to artifical classes
//printf("getResolvedClass(%s,%s)=%s\n",scope?scope->name().data():"<global>",
// n,result?result->name().data():"<none>");
return result;
} }
//-------------------------------------------------------------------------
//-------------------------------------------------------------------------
//-------------------------------------------------------------------------
//-------------------------------------------------------------------------
static bool findOperator(const QCString &s,int i) static bool findOperator(const QCString &s,int i)
{ {
int b = s.findRev("operator",i); int b = s.findRev("operator",i);
...@@ -773,7 +1209,12 @@ QCString removeRedundantWhiteSpace(const QCString &s) ...@@ -773,7 +1209,12 @@ QCString removeRedundantWhiteSpace(const QCString &s)
result+=' '; result+=' ';
result+=s.at(i); result+=s.at(i);
} }
else if (c==':' && csp==6) else if (c=='t' && csp==5) // prevent const ::A from being converted to const::A
{
result+="t ";
csp=0;
}
else if (c==':' && csp==6) // replace const::A by const ::A
{ {
result+=" :"; result+=" :";
csp=0; csp=0;
...@@ -882,25 +1323,26 @@ void linkifyText(const TextGeneratorIntf &out,Definition *scope,const char * /*n ...@@ -882,25 +1323,26 @@ void linkifyText(const TextGeneratorIntf &out,Definition *scope,const char * /*n
//printf("word=`%s' scope=`%s'\n", //printf("word=`%s' scope=`%s'\n",
// word.data(),scope ? scope->name().data() : "<none>" // word.data(),scope ? scope->name().data() : "<none>"
// ); // );
Definition *curScope = scope; // Definition *curScope = scope;
// check if `word' is a documented class name // check if `word' is a documented class name
//int scopeOffset=scopeName.length(); //int scopeOffset=scopeName.length();
do // for each scope (starting with full scope and going to empty scope) // do // for each scope (starting with full scope and going to empty scope)
{ // {
//printf("Searching %s in %s...\n",word.data(),curScope?curScope->name().data():"<global>"); //printf("Searching %s in %s...\n",word.data(),curScope?curScope->name().data():"<global>");
QCString fullName = word; // QCString fullName = word;
QCString prefix; // QCString prefix;
replaceNamespaceAliases(fullName,fullName.length()); // replaceNamespaceAliases(fullName,fullName.length());
//if (scopeOffset>0) // //if (scopeOffset>0)
if (curScope && curScope!=Doxygen::globalScope) // if (curScope && curScope!=Doxygen::globalScope)
{ // {
prefix = curScope->name(); // prefix = curScope->name();
replaceNamespaceAliases(prefix,prefix.length()); // replaceNamespaceAliases(prefix,prefix.length());
fullName.prepend(prefix+"::"); // fullName.prepend(prefix+"::");
} // }
bool isTypeDef=FALSE; // bool isTypeDef=FALSE;
if ((cd=getResolvedClass(scope,fullName,&isTypeDef))) if ((cd=getResolvedClass(scope,0,word/*fullName,&isTypeDef*/)))
// todo: fill in fileScope
{ {
// add link to the result // add link to the result
if (external ? cd->isLinkable() : cd->isLinkableInProject()) if (external ? cd->isLinkable() : cd->isLinkableInProject())
...@@ -909,16 +1351,16 @@ void linkifyText(const TextGeneratorIntf &out,Definition *scope,const char * /*n ...@@ -909,16 +1351,16 @@ void linkifyText(const TextGeneratorIntf &out,Definition *scope,const char * /*n
found=TRUE; found=TRUE;
} }
} }
else if (isTypeDef) // else if (isTypeDef)
{ // {
goto endloop; // goto endloop;
} // }
if (curScope) curScope = curScope->getOuterScope(); // if (curScope) curScope = curScope->getOuterScope();
} //while (!found && scopeOffset>=0); // } //while (!found && scopeOffset>=0);
while (!found && curScope); // while (!found && curScope);
endloop: //endloop:
if (scope && if (scope &&
(scope->definitionType()==Definition::TypeClass || (scope->definitionType()==Definition::TypeClass ||
scope->definitionType()==Definition::TypeNamespace scope->definitionType()==Definition::TypeNamespace
...@@ -1551,10 +1993,10 @@ void stripIrrelevantConstVolatile(QCString &s) ...@@ -1551,10 +1993,10 @@ void stripIrrelevantConstVolatile(QCString &s)
if (s=="volatile") { s.resize(0); return; } if (s=="volatile") { s.resize(0); return; }
// strip occurrences of const // strip occurrences of const
int constLen=6; int constLen=5+1;
i = s.find("const "); i = s.find("const ");
if (i==-1 && s.right(5)=="const") { i=s.length()-5;constLen=5; } if (i==-1 && s.right(5)=="const") { i=s.length()-5;constLen=5; }
if (i!=-1) while (i!=-1)
{ {
// no & or * after the const // no & or * after the const
int i1=s.find('*',i+constLen); int i1=s.find('*',i+constLen);
...@@ -1562,19 +2004,21 @@ void stripIrrelevantConstVolatile(QCString &s) ...@@ -1562,19 +2004,21 @@ void stripIrrelevantConstVolatile(QCString &s)
if (i1==-1 && i2==-1) if (i1==-1 && i2==-1)
{ {
s=s.left(i)+s.right(s.length()-i-constLen); s=s.left(i)+s.right(s.length()-i-constLen);
i-=constLen;
} }
else if ((i1!=-1 && i<i1) || (i2!=-1 && i<i2)) // const before * or & else if ((i1!=-1 && i<i1) || (i2!=-1 && i<i2)) // const before * or &
{ {
// move const to front // move const to front
s=(QCString)"const "+s.left(i)+s.right(s.length()-i-constLen); s=(QCString)"const "+s.left(i)+s.right(s.length()-i-constLen);
} }
i = s.find("const ",i+constLen);
} }
// strip occurrences of volatile // strip occurrences of volatile
int volatileLen=6; int volatileLen=8+1;
i = s.find("volatile "); i = s.find("volatile ");
if (i==-1 && s.right(8)=="volatile") { i=s.length()-8;constLen=8; } if (i==-1 && s.right(8)=="volatile") { i=s.length()-8;constLen=8; }
if (i!=-1) while (i!=-1)
{ {
// no & or * after the volatile // no & or * after the volatile
int i1=s.find('*',i+volatileLen); int i1=s.find('*',i+volatileLen);
...@@ -1582,12 +2026,14 @@ void stripIrrelevantConstVolatile(QCString &s) ...@@ -1582,12 +2026,14 @@ void stripIrrelevantConstVolatile(QCString &s)
if (i1==-1 && i2==-1) if (i1==-1 && i2==-1)
{ {
s=s.left(i)+s.right(s.length()-i-volatileLen); s=s.left(i)+s.right(s.length()-i-volatileLen);
i-=volatileLen;
} }
else if ((i1!=-1 && i<i1) || (i2!=-1 && i<i2)) // volatile before * or & else if ((i1!=-1 && i<i1) || (i2!=-1 && i<i2)) // volatile before * or &
{ {
// move volatile to front // move volatile to front
s=(QCString)"volatile "+s.left(i)+s.right(s.length()-i-volatileLen); s=(QCString)"volatile "+s.left(i)+s.right(s.length()-i-volatileLen);
} }
i = s.find("volatile ",i+volatileLen);
} }
//printf("%s\n",s.data()); //printf("%s\n",s.data());
} }
...@@ -1602,8 +2048,8 @@ void stripIrrelevantConstVolatile(QCString &s) ...@@ -1602,8 +2048,8 @@ void stripIrrelevantConstVolatile(QCString &s)
static bool matchArgument(const Argument *srcA,const Argument *dstA, static bool matchArgument(const Argument *srcA,const Argument *dstA,
const QCString &className, const QCString &className,
const QCString &namespaceName, const QCString &namespaceName,
NamespaceList *usingNamespaces, NamespaceSDict *usingNamespaces,
ClassList *usingClasses) ClassSDict *usingClasses)
{ {
//printf("match argument start %s:%s <-> %s:%s using nsp=%p class=%p\n", //printf("match argument start %s:%s <-> %s:%s using nsp=%p class=%p\n",
// srcA->type.data(),srcA->name.data(), // srcA->type.data(),srcA->name.data(),
...@@ -1707,7 +2153,7 @@ static bool matchArgument(const Argument *srcA,const Argument *dstA, ...@@ -1707,7 +2153,7 @@ static bool matchArgument(const Argument *srcA,const Argument *dstA,
} }
if (usingNamespaces && usingNamespaces->count()>0) if (usingNamespaces && usingNamespaces->count()>0)
{ {
NamespaceListIterator nli(*usingNamespaces); NamespaceSDict::Iterator nli(*usingNamespaces);
NamespaceDef *nd; NamespaceDef *nd;
for (;(nd=nli.current());++nli) for (;(nd=nli.current());++nli)
{ {
...@@ -1717,7 +2163,7 @@ static bool matchArgument(const Argument *srcA,const Argument *dstA, ...@@ -1717,7 +2163,7 @@ static bool matchArgument(const Argument *srcA,const Argument *dstA,
} }
if (usingClasses && usingClasses->count()>0) if (usingClasses && usingClasses->count()>0)
{ {
ClassListIterator cli(*usingClasses); ClassSDict::Iterator cli(*usingClasses);
ClassDef *cd; ClassDef *cd;
for (;(cd=cli.current());++cli) for (;(cd=cli.current());++cli)
{ {
...@@ -1869,8 +2315,8 @@ static bool matchArgument(const Argument *srcA,const Argument *dstA, ...@@ -1869,8 +2315,8 @@ static bool matchArgument(const Argument *srcA,const Argument *dstA,
*/ */
bool matchArguments(ArgumentList *srcAl,ArgumentList *dstAl, bool matchArguments(ArgumentList *srcAl,ArgumentList *dstAl,
const char *cl,const char *ns,bool checkCV, const char *cl,const char *ns,bool checkCV,
NamespaceList *usingNamespaces, NamespaceSDict *usingNamespaces,
ClassList *usingClasses) ClassSDict *usingClasses)
{ {
QCString className=cl; QCString className=cl;
QCString namespaceName=ns; QCString namespaceName=ns;
...@@ -2162,7 +2608,8 @@ bool getDefs(const QCString &scName,const QCString &memberName, ...@@ -2162,7 +2608,8 @@ bool getDefs(const QCString &scName,const QCString &memberName,
//printf("Trying class scope %s\n",className.data()); //printf("Trying class scope %s\n",className.data());
ClassDef *fcd=0; ClassDef *fcd=0;
if ((fcd=getResolvedClass(Doxygen::globalScope,className)) && // is it a documented class // todo: fill in correct fileScope!
if ((fcd=getResolvedClass(Doxygen::globalScope,0,className)) && // is it a documented class
fcd->isLinkable() fcd->isLinkable()
) )
{ {
......
...@@ -40,7 +40,7 @@ class ExampleSDict; ...@@ -40,7 +40,7 @@ class ExampleSDict;
class ClassSDict; class ClassSDict;
class BaseClassList; class BaseClassList;
class GroupDef; class GroupDef;
class NamespaceList; class NamespaceSDict;
class ClassList; class ClassList;
class MemberGroupSDict; class MemberGroupSDict;
class Definition; class Definition;
...@@ -121,14 +121,15 @@ void writePageRef(OutputDocInterface &od,const char *cn,const char *mn); ...@@ -121,14 +121,15 @@ void writePageRef(OutputDocInterface &od,const char *cn,const char *mn);
bool matchArguments(ArgumentList *,ArgumentList *, bool matchArguments(ArgumentList *,ArgumentList *,
const char *cl=0,const char *ns=0,bool checkCV=TRUE, const char *cl=0,const char *ns=0,bool checkCV=TRUE,
NamespaceList *usingNamespaces=0, NamespaceSDict *usingNamespaces=0,
ClassList *usingClasses=0); ClassSDict *usingClasses=0);
void mergeArguments(ArgumentList *,ArgumentList *,bool forceNameOverwrite=FALSE); void mergeArguments(ArgumentList *,ArgumentList *,bool forceNameOverwrite=FALSE);
QCString substituteClassNames(const QCString &s); QCString substituteClassNames(const QCString &s);
QCString substitute(const char *s,const char *src,const char *dst); QCString substitute(const char *s,const char *src,const char *dst);
QCString resolveDefines(const char *n); QCString resolveDefines(const char *n);
ClassDef *getClass(const char *key); ClassDef *getClass(const char *key);
ClassDef *getResolvedClass(Definition *scope, ClassDef *getResolvedClass(Definition *scope,
FileDef *fileScope,
const char *key, const char *key,
bool *pIsTypeDef=0, bool *pIsTypeDef=0,
QCString *pTemplSpec=0); QCString *pTemplSpec=0);
...@@ -201,6 +202,9 @@ QCString rtfFormatBmkStr(const char *name); ...@@ -201,6 +202,9 @@ QCString rtfFormatBmkStr(const char *name);
QCString linkToText(const char *link,bool isFileName); QCString linkToText(const char *link,bool isFileName);
QCString stripExtension(const char *fName); QCString stripExtension(const char *fName);
void replaceNamespaceAliases(QCString &scope,int i); void replaceNamespaceAliases(QCString &scope,int i);
int isAccessibleFrom(Definition *scope,FileDef *fileScope,Definition *item);
int isAccessibleFrom(Definition *scope,FileDef *fileScope,Definition *item,
const QCString &explicitScopePart);
#endif #endif
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment