From 397c31a2d64173c0dc50567896fee378bea2fca0 Mon Sep 17 00:00:00 2001 From: Dimitri van Heesch Date: Sun, 4 Aug 2013 12:06:25 +0200 Subject: Bug 691830 - Logical confusion with DISABLE_INDEX and GENERATE_TREEVIEW --- addon/doxywizard/configdoc.cpp | 10 +++++----- doc/config.doc | 43 +++++++++++++++++++++--------------------- src/config.xml | 11 ++++++----- src/configoptions.cpp | 10 +++++----- 4 files changed, 38 insertions(+), 36 deletions(-) diff --git a/addon/doxywizard/configdoc.cpp b/addon/doxywizard/configdoc.cpp index 1ced316..8f4c9e4 100644 --- a/addon/doxywizard/configdoc.cpp +++ b/addon/doxywizard/configdoc.cpp @@ -1297,9 +1297,9 @@ void addConfigDocs(DocIntf *doc) "be necessary to disable the index and replace it with your own. The\n" "DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top\n" "of each HTML page. A value of NO enables the index and the value YES disables\n" - "it. Since the tabs have the same information as the navigation tree you can\n" - "set this option to NO if you already set GENERATE_TREEVIEW to YES.Default\n" - "value: NO.\n" + "it. Since the tabs in the index contain the same information as the navigation\n" + "tree, you can set this option to YES if you also set GENERATE_TREEVIEW to\n" + "YES.Default value: NO.\n" "\n" "This tag requires that the tag GENERATE_HTML is set to YES." ); @@ -1315,8 +1315,8 @@ void addConfigDocs(DocIntf *doc) "further fine-tune the look of the index. As an example, the default style\n" "sheet generated by doxygen has an example that shows how to put an image at\n" "the root of the tree instead of the PROJECT_NAME. Since the tree basically has\n" - "the same information as the tab index you could consider to set DISABLE_INDEX\n" - "to NO when enabling this option.Default value: NO.\n" + "the same information as the tab index, you could consider setting\n" + "DISABLE_INDEX to YES when enabling this option.Default value: NO.\n" "\n" "This tag requires that the tag GENERATE_HTML is set to YES." ); diff --git a/doc/config.doc b/doc/config.doc index d57de28..14627a7 100644 --- a/doc/config.doc +++ b/doc/config.doc @@ -598,7 +598,7 @@ The default value is: NO. 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. -Minumum value: 1, maximum value: 16, default value: 4. + Minimum value: 1, maximum value: 16, default value: 4. \anchor cfg_aliases
\c ALIASES
@@ -815,7 +815,7 @@ The default value is: NO. At the end of a run doxygen will report the cache usage and suggest the optimal cache size from a speed point of view. -Minumum value: 0, maximum value: 9, default value: 0. + Minimum value: 0, maximum value: 9, default value: 0. \section config_build Build related configuration options @@ -1114,7 +1114,7 @@ The default value is: YES. individual variables and macros / defines can be controlled using \ref cmdshowinitializer "\\showinitializer" or \ref cmdhideinitializer "\\hideinitializer" command in the documentation regardless of this setting. -Minumum value: 0, maximum value: 10000, default value: 30. + Minimum value: 0, maximum value: 10000, default value: 30. \anchor cfg_show_used_files
\c SHOW_USED_FILES
@@ -1634,7 +1634,7 @@ The default value is: YES. The \c COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns in which the alphabetical index list will be split. -Minumum value: 1, maximum value: 20, default value: 5. + Minimum value: 1, maximum value: 20, default value: 5. This tag requires that the tag \ref cfg_alphabetical_index "ALPHABETICAL_INDEX" is set to \c YES. \anchor cfg_ignore_prefix @@ -1863,7 +1863,7 @@ This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to 180 is cyan, 240 is blue, 300 purple, and 360 is red again. The allowed range is 0 to 359. -Minumum value: 0, maximum value: 359, default value: 220. + Minimum value: 0, maximum value: 359, default value: 220. This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to \c YES. \anchor cfg_html_colorstyle_sat @@ -1873,7 +1873,7 @@ This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to the colors in the HTML output. For a value of 0 the output will use grayscales only. A value of 255 will produce the most vivid colors. -Minumum value: 0, maximum value: 255, default value: 100. + Minimum value: 0, maximum value: 255, default value: 100. This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to \c YES. \anchor cfg_html_colorstyle_gamma @@ -1886,7 +1886,7 @@ This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to so 80 represents a gamma of 0.8, The value 220 represents a gamma of 2.2, and 100 does not change the gamma. -Minumum value: 40, maximum value: 240, default value: 80. + Minimum value: 40, maximum value: 240, default value: 80. This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to \c YES. \anchor cfg_html_timestamp @@ -1922,7 +1922,7 @@ This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to default. 0 is a special value representing an infinite number of entries and will result in a full expanded tree by default. -Minumum value: 0, maximum value: 9999, default value: 100. + Minimum value: 0, maximum value: 9999, default value: 100. This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to \c YES. \anchor cfg_generate_docset @@ -2160,9 +2160,9 @@ This tag requires that the tag \ref cfg_generate_eclipsehelp "GENERATE_ECLIPSEHE might be necessary to disable the index and replace it with your own. The \c DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top of each HTML page. A value of \c NO enables the index and the - value \c YES disables it. Since the tabs have the same information as the - navigation tree you can set this option to \c NO if you already set - \ref cfg_generate_treeview "GENERATE_TREEVIEW" to \c YES. + value \c YES disables it. Since the tabs in the index contain the same + information as the navigation tree, you can set this option to \c YES if + you also set \ref cfg_generate_treeview "GENERATE_TREEVIEW" to \c YES. The default value is: NO. @@ -2184,8 +2184,9 @@ This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to example that shows how to put an image at the root of the tree instead of the \ref cfg_project_name "PROJECT_NAME". - Since the tree basically has the same information as the tab index you - could consider to set \ref cfg_disable_index "DISABLE_INDEX" to \c NO when enabling this option. + Since the tree basically has the same information as the tab index, you could + consider setting \ref cfg_disable_index "DISABLE_INDEX" to \c YES when + enabling this option. The default value is: NO. @@ -2198,7 +2199,7 @@ This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to
Note that a value of 0 will completely suppress the enum values from appearing in the overview section. -Minumum value: 0, maximum value: 20, default value: 4. + Minimum value: 0, maximum value: 20, default value: 4. This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to \c YES. \anchor cfg_treeview_width @@ -2208,7 +2209,7 @@ This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to used to set the initial width (in pixels) of the frame in which the tree is shown. -Minumum value: 0, maximum value: 1500, default value: 250. + Minimum value: 0, maximum value: 1500, default value: 250. This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to \c YES. \anchor cfg_ext_links_in_window @@ -2229,7 +2230,7 @@ This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to to manually remove any `form_*.png` images from the HTML output directory to force them to be regenerated. -Minumum value: 8, maximum value: 50, default value: 10. + Minimum value: 8, maximum value: 50, default value: 10. This tag requires that the tag \ref cfg_generate_html "GENERATE_HTML" is set to \c YES. \anchor cfg_formula_transparent @@ -3074,7 +3075,7 @@ The default value is: NO. explicitly to a value larger than 0 to get control over the balance between CPU load and processing speed. -Minumum value: 0, maximum value: 32, default value: 0. + Minimum value: 0, maximum value: 32, default value: 0. This tag requires that the tag \ref cfg_have_dot "HAVE_DOT" is set to \c YES. \anchor cfg_dot_fontname @@ -3094,7 +3095,7 @@ This tag requires that the tag \ref cfg_have_dot "HAVE_DOT" is set to \c YES. \addindex DOT_FONTSIZE The \c DOT_FONTSIZE tag can be used to set the size (in points) of the font of dot graphs. -Minumum value: 4, maximum value: 24, default value: 10. + Minimum value: 4, maximum value: 24, default value: 10. This tag requires that the tag \ref cfg_have_dot "HAVE_DOT" is set to \c YES. \anchor cfg_dot_fontpath @@ -3159,7 +3160,7 @@ This tag requires that the tag \ref cfg_have_dot "HAVE_DOT" is set to \c YES. to 10, up to 15 fields may appear, but if the number exceeds 15, the total amount of fields shown is limited to 10. -Minumum value: 0, maximum value: 100, default value: 10. + Minimum value: 0, maximum value: 100, default value: 10. This tag requires that the tag \ref cfg_have_dot "HAVE_DOT" is set to \c YES. \anchor cfg_template_relations @@ -3303,7 +3304,7 @@ This tag requires that the tag \ref cfg_have_dot "HAVE_DOT" is set to \c YES. \c DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note that the size of a graph can be further restricted by \ref cfg_max_dot_graph_depth "MAX_DOT_GRAPH_DEPTH". -Minumum value: 0, maximum value: 10000, default value: 50. + Minimum value: 0, maximum value: 10000, default value: 50. This tag requires that the tag \ref cfg_have_dot "HAVE_DOT" is set to \c YES. \anchor cfg_max_dot_graph_depth @@ -3317,7 +3318,7 @@ This tag requires that the tag \ref cfg_have_dot "HAVE_DOT" is set to \c YES. code bases. Also note that the size of a graph can be further restricted by \ref cfg_dot_graph_max_nodes "DOT_GRAPH_MAX_NODES". Using a depth of 0 means no depth restriction. -Minumum value: 0, maximum value: 1000, default value: 0. + Minimum value: 0, maximum value: 1000, default value: 0. This tag requires that the tag \ref cfg_have_dot "HAVE_DOT" is set to \c YES. \anchor cfg_dot_transparent diff --git a/src/config.xml b/src/config.xml index d73a26c..1630c6b 100644 --- a/src/config.xml +++ b/src/config.xml @@ -2122,9 +2122,9 @@ The \c DOCSET_PUBLISHER_NAME tag identifies the documentation publisher. might be necessary to disable the index and replace it with your own. The \c DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top of each HTML page. A value of \c NO enables the index and the - value \c YES disables it. Since the tabs have the same information as the - navigation tree you can set this option to \c NO if you already set - \ref cfg_generate_treeview "GENERATE_TREEVIEW" to \c YES. + value \c YES disables it. Since the tabs in the index contain the same + information as the navigation tree, you can set this option to \c YES if + you also set \ref cfg_generate_treeview "GENERATE_TREEVIEW" to \c YES. ]]> @@ -2145,8 +2145,9 @@ The \c DOCSET_PUBLISHER_NAME tag identifies the documentation publisher. example that shows how to put an image at the root of the tree instead of the \ref cfg_project_name "PROJECT_NAME". - Since the tree basically has the same information as the tab index you - could consider to set \ref cfg_disable_index "DISABLE_INDEX" to \c NO when enabling this option. + Since the tree basically has the same information as the tab index, you could + consider setting \ref cfg_disable_index "DISABLE_INDEX" to \c YES when + enabling this option. ]]> diff --git a/src/configoptions.cpp b/src/configoptions.cpp index 1dc4a06..26de2fd 100644 --- a/src/configoptions.cpp +++ b/src/configoptions.cpp @@ -1761,9 +1761,9 @@ void addConfigOptions(Config *cfg) "be necessary to disable the index and replace it with your own. The\n" "DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top\n" "of each HTML page. A value of NO enables the index and the value YES disables\n" - "it. Since the tabs have the same information as the navigation tree you can\n" - "set this option to NO if you already set GENERATE_TREEVIEW to YES.Default\n" - "value: NO.\n" + "it. Since the tabs in the index contain the same information as the navigation\n" + "tree, you can set this option to YES if you also set GENERATE_TREEVIEW to\n" + "YES.Default value: NO.\n" "\n" "This tag requires that the tag GENERATE_HTML is set to YES.", FALSE @@ -1782,8 +1782,8 @@ void addConfigOptions(Config *cfg) "further fine-tune the look of the index. As an example, the default style\n" "sheet generated by doxygen has an example that shows how to put an image at\n" "the root of the tree instead of the PROJECT_NAME. Since the tree basically has\n" - "the same information as the tab index you could consider to set DISABLE_INDEX\n" - "to NO when enabling this option.Default value: NO.\n" + "the same information as the tab index, you could consider setting\n" + "DISABLE_INDEX to YES when enabling this option.Default value: NO.\n" "\n" "This tag requires that the tag GENERATE_HTML is set to YES.", FALSE -- cgit v0.12