summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authoralbert-github <albert.tests@gmail.com>2019-02-22 12:40:09 (GMT)
committeralbert-github <albert.tests@gmail.com>2019-02-22 12:40:09 (GMT)
commit351d64c35502c64ff446458e8ad6892b3f22ead4 (patch)
tree0876cc45871e0865e570f8dd6a6773e6a2c4900d /src
parentd562d7a4bf3cec36858bdc8b01245da042024817 (diff)
downloadDoxygen-351d64c35502c64ff446458e8ad6892b3f22ead4.zip
Doxygen-351d64c35502c64ff446458e8ad6892b3f22ead4.tar.gz
Doxygen-351d64c35502c64ff446458e8ad6892b3f22ead4.tar.bz2
Remove some doxygen warnings in internal documentation
Generating the doxygen internal documentation gave some warning messages, these have been corrected.
Diffstat (limited to 'src')
-rw-r--r--src/config.h2
-rw-r--r--src/doxygen.md20
-rw-r--r--src/emoji.cpp4
3 files changed, 14 insertions, 12 deletions
diff --git a/src/config.h b/src/config.h
index 102774e..1b79b1e 100644
--- a/src/config.h
+++ b/src/config.h
@@ -65,6 +65,8 @@ namespace Config
/*! Post processed the parsed data. Replaces raw string values by the actual values.
* and replaces environment variables.
* \param clearHeaderAndFooter set to TRUE when writing header and footer templates.
+ * \param compare signals if we in Doxyfile compare (`-x`) mode are or not. Influences
+ * setting of the default value.
*/
void postProcess(bool clearHeaderAndFooter, bool compare = FALSE);
diff --git a/src/doxygen.md b/src/doxygen.md
index 17144ec..7680a94 100644
--- a/src/doxygen.md
+++ b/src/doxygen.md
@@ -2,17 +2,17 @@ Doxygen Internals {#mainpage}
=================
Introduction
-------------
+============
This page provides a high-level overview of the internals of doxygen, with
links to the relevant parts of the code. This document is intended for
developers who want to work on doxygen. Users of doxygen are referred to the
-[User Manual](http://www.doxygen.org/manual.html).
+[User Manual](http://www.doxygen.nl/manual/index.html).
The generic starting point of the application is of course the main() function.
Configuration options
----------------------
+=====================
Configuration file data is stored in singleton class Config and can be
accessed using wrapper macros
@@ -22,20 +22,20 @@ option.
The format of the configuration file (options and types) is defined
by the file `config.xml`. As part of the build process,
-the python script `configgen.py` will create a file configoptions.cpp
+the python script `configgen.py` will create a file `configoptions.cpp`
from this, which serves as the input for the configuration file parser
that is invoked using Config::parse(). The script `configgen.py` will also
create the documentation for the configuration items, creating the file
`config.doc`.
Gathering Input files
----------------------
+=====================
After the configuration is known, the input files are searched using
searchInputFiles() and any tag files are read using readTagFile()
Parsing Input files
--------------------
+===================
The function parseFiles() takes care of parsing all files.
It uses the ParserManager singleton factory to create a suitable parser object
@@ -71,7 +71,7 @@ extracted like section labels, xref items, and formulas.
Also Markdown markup is processed using processMarkdown() during this pass.
Resolving relations
--------------------
+===================
The Entry objects created and filled during parsing are stored on disk
(to keep memory needs low). The name, parent/child relation, and
@@ -98,7 +98,7 @@ Finally the data for members of classes, namespaces, and files is stored in
the subclass MemberDef.
Producing debug output
-----------------------
+======================
Within doxygen there are a number of ways to obtain debug output. Besides the
invasive method of putting print statements in the code there are a number of
@@ -174,12 +174,12 @@ easy ways to get debug information.
problem occurs. This makes it easier to select the file to be compiled in `lex` debug mode.
Producing output
-----------------
+================
TODO
Topics TODO
------------
+===========
- Grouping of files in Model / Parser / Generator categories
- Index files based on IndexIntf
- HTML navigation
diff --git a/src/emoji.cpp b/src/emoji.cpp
index c332083..311f748 100644
--- a/src/emoji.cpp
+++ b/src/emoji.cpp
@@ -1578,7 +1578,7 @@ void EmojiEntityMapper::writeEmojiFile(QFile &file)
/*! @brief Access routine to the unicode sequence for the Emoji entity
*
- * @param symb code of the requested Emoji entity returned by symbol2index()
+ * @param index code of the requested Emoji entity returned by symbol2index()
* @return the unicode sequence of the Emoji entity,
*/
const char *EmojiEntityMapper::unicode(int index) const
@@ -1588,7 +1588,7 @@ const char *EmojiEntityMapper::unicode(int index) const
/*! @brief Access routine to the name of the Emoji entity
*
- * @param symb code of the requested Emoji entity returned by symbol2index()
+ * @param index code of the requested Emoji entity returned by symbol2index()
* @return the name of the Emoji entity in GitHub format (i.e. :smile:)
*/
const char *EmojiEntityMapper::name(int index) const