summaryrefslogtreecommitdiffstats
path: root/src/configoptions.cpp
diff options
context:
space:
mode:
Diffstat (limited to 'src/configoptions.cpp')
-rw-r--r--src/configoptions.cpp36
1 files changed, 25 insertions, 11 deletions
diff --git a/src/configoptions.cpp b/src/configoptions.cpp
index 8522389..4fdaf90 100644
--- a/src/configoptions.cpp
+++ b/src/configoptions.cpp
@@ -45,7 +45,9 @@ void addConfigOptions(Config *cfg)
//----
cs = cfg->addString(
"PROJECT_BRIEF",
- "Using the PROJECT_BRIEF tag one can provide an optional one line description for a project that appears at the top of each page and should give viewer a quick idea about the purpose of the project. Keep the description short."
+ "Using the PROJECT_BRIEF tag one can provide an optional one line description\n"
+ "for a project that appears at the top of each page and should give viewer\n"
+ "a quick idea about the purpose of the project. Keep the description short."
);
//----
cs = cfg->addString(
@@ -616,8 +618,11 @@ void addConfigOptions(Config *cfg)
//----
cb = cfg->addBool(
"STRICT_PROTO_MATCHING",
- "If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to do proper type resolution of all parameters of a function it will reject a\n"
- "match between the prototype and the implementation of a member function even if there is only one candidate or it is obvious which candidate to choose by doing a simple string match. By disabling STRICT_PROTO_MATCHING doxygen\n"
+ "If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to\n"
+ "do proper type resolution of all parameters of a function it will reject a\n"
+ "match between the prototype and the implementation of a member function even\n"
+ "if there is only one candidate or it is obvious which candidate to choose\n"
+ "by doing a simple string match. By disabling STRICT_PROTO_MATCHING doxygen\n"
"will still accept a match between prototype and implementation in such cases.",
FALSE
);
@@ -1114,7 +1119,13 @@ void addConfigOptions(Config *cfg)
"HTML_HEADER",
"The HTML_HEADER tag can be used to specify a personal HTML header for\n"
"each generated HTML page. If it is left blank doxygen will generate a\n"
- "standard header."
+ "standard header. Note that when using a custom header you are responsible\n"
+ "for the proper inclusion of any scripts and style sheets that doxygen\n"
+ "needs, which is dependent on the configuration options used.\n"
+ "It is adviced to generate a default header using \"doxygen -w html\n"
+ "header.html footer.html stylesheet.css YourConfigFile\" and then modify\n"
+ "that header. Note that the header is subject to change so you typically\n"
+ "have to redo this when upgrading to a newer version of doxygen or when changing the value of configuration settings such as GENERATE_TREEVIEW!"
);
cs->setWidgetType(ConfigString::File);
cs->addDependency("GENERATE_HTML");
@@ -1426,9 +1437,10 @@ void addConfigOptions(Config *cfg)
//----
ci = cfg->addInt(
"ENUM_VALUES_PER_LINE",
- "This tag can be used to set the number of enum values (range [0,1..20])\n"
- "that doxygen will group on one line in the generated HTML documentation.\n"
- "Note that a value of 0 will completely suppress the enum values from appearing in the overview section.",
+ "The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values\n"
+ "(range [0,1..20]) that doxygen will group on one line in the generated HTML\n"
+ "documentation. Note that a value of 0 will completely suppress the enum\n"
+ "values from appearing in the overview section.",
0,20,4
);
ci->addDependency("GENERATE_HTML");
@@ -1510,7 +1522,8 @@ void addConfigOptions(Config *cfg)
"HTML output directory using the MATHJAX_RELPATH option. The destination\n"
"directory should contain the MathJax.js script. For instance, if the mathjax\n"
"directory is located at the same level as the HTML output directory, then\n"
- "MATHJAX_RELPATH should be ../mathjax. The default value points to the mathjax.org site, so you can quickly see the result without installing\n"
+ "MATHJAX_RELPATH should be ../mathjax. The default value points to the\n"
+ "mathjax.org site, so you can quickly see the result without installing\n"
"MathJax, but it is strongly recommended to install a local copy of MathJax\n"
"before deployment."
);
@@ -1914,7 +1927,7 @@ void addConfigOptions(Config *cfg)
cb = cfg->addBool(
"SEARCH_INCLUDES",
"If the SEARCH_INCLUDES tag is set to YES (the default) the includes files\n"
- "in the INCLUDE_PATH (see below) will be search if a #include is found.",
+ "pointed to by INCLUDE_PATH will be searched when a #include is found.",
TRUE
);
cb->addDependency("ENABLE_PREPROCESSING");
@@ -1954,7 +1967,8 @@ void addConfigOptions(Config *cfg)
"If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then\n"
"this tag can be used to specify a list of macro names that should be expanded.\n"
"The macro definition that is found in the sources will be used.\n"
- "Use the PREDEFINED tag if you want to use a different macro definition that overrules the definition found in the source code."
+ "Use the PREDEFINED tag if you want to use a different macro definition that\n"
+ "overrules the definition found in the source code."
);
cl->addDependency("ENABLE_PREPROCESSING");
//----
@@ -2213,7 +2227,7 @@ void addConfigOptions(Config *cfg)
ce = cfg->addEnum(
"DOT_IMAGE_FORMAT",
"The DOT_IMAGE_FORMAT tag can be used to set the image format of the images\n"
- "generated by dot. Possible values are png, svg, gif or svg.\n"
+ "generated by dot. Possible values are svg, png, jpg, or gif.\n"
"If left blank png will be used.",
"png"
);