Release-1.6.1-20091222

Doxyfile

@@ -224,7 +224,7 @@ GENERATE_AUTOGEN_DEF   = NO
 #---------------------------------------------------------------------------
 # configuration options related to the Perl module output
 #---------------------------------------------------------------------------
-GENERATE_PERLMOD       = NO
+GENERATE_PERLMOD       = YES
 PERLMOD_LATEX          = NO
 PERLMOD_PRETTY         = YES
 PERLMOD_MAKEVAR_PREFIX = 

INSTALL

@@ -1,7 +1,7 @@
-DOXYGEN Version 1.6.1-20091027
+DOXYGEN Version 1.6.1-20091222
 
 Please read the installation section of the manual 
 (http://www.doxygen.org/install.html) for instructions.
 
 --------
-Dimitri van Heesch (27 October 2009)
+Dimitri van Heesch (22 December 2009)

README

@@ -1,4 +1,4 @@
-DOXYGEN Version 1.6.1_20091027
+DOXYGEN Version 1.6.1_20091222
 
 Please read INSTALL for compilation instructions.
 
@@ -17,4 +17,4 @@ to subscribe to the lists or to visit the archives.
 
 Enjoy,
 
-Dimitri van Heesch ([email protected]) (27 October 2009)
+Dimitri van Heesch ([email protected]) (22 December 2009)

configure

@@ -20,7 +20,7 @@ doxygen_version_minor=6
 doxygen_version_revision=1
 
 #NOTE: Setting version_mmn to "NO" will omit mmn info from the package.
-doxygen_version_mmn=20091027
+doxygen_version_mmn=20091222
 
 bin_dirs=`echo $PATH | sed -e "s/:/ /g"`
 

doc/Doxyfile

@@ -33,7 +33,8 @@ CASE_SENSE_NAMES  = NO
 IMAGE_PATH        = .
 INPUT             = index.doc install.doc starting.doc docblocks.doc lists.doc \
                     grouping.doc formulas.doc diagrams.doc preprocessing.doc \
-                    autolink.doc output.doc customize.doc custcmd.doc external.doc faq.doc trouble.doc history.doc features.doc \
+                    autolink.doc output.doc searching.doc customize.doc custcmd.doc \
+                    external.doc faq.doc trouble.doc history.doc features.doc \
 		    doxygen_usage.doc doxytag_usage.doc \
                     doxywizard_usage.doc installdox_usage.doc \
 		    config.doc commands.doc htmlcmds.doc xmlcmds.doc language.doc \

doc/commands.doc

@@ -466,10 +466,34 @@ Structural indicators
   The \<header-name\> argument can be used to overwrite the 
   name of the link that is used in the class documentation to something other 
   than \<header-file\>. This can be useful if the include name is not located 
-  on the default include path (like \<X11/X.h\>). With the \<header-name\>
+  on the default include path (like \<X11/X.h\>). 
+
+  With the \<header-name\>
   argument you can also specify how the include statement should look like, 
-  by adding either quotes or sharp brackets around the name. 
-  Sharp brackets are used if just the name is given.
+  by adding either double quotes or sharp brackets around the name. 
+  By default sharp brackets are used if just the name is given. 
+
+  If a pair of double quotes is given for either the header-file or 
+  header-name argument, the current file (in which the command was found) 
+  will be used but with quotes. So for a comment block with a \\headerfile
+  command inside a file test.h, the following three commands are equivalent:
+  \verbatim
+  \headerfile test.h "test.h"
+  \headerfile test.h ""
+  \headerfile "" \endverbatim
+  To get sharp brackets you do not need to specify anything,
+  but if you want to be explicit you could use any of the following:
+  \verbatim
+  \headerfile test.h <test.h>
+  \headerfile test.h <>
+  \headerfile <> \endverbatim
+
+  To globally reverse the default include representation to 
+  local includes you can set
+  \ref cfg_force_local_includes "FORCE_LOCAL_INCLUDES" to \c YES.
+
+  To disable the include information altogether set
+  \ref cfg_show_include_files "SHOW_INCLUDE_FILES" to \c NO.
 
 <hr>
 \section cmdhideinitializer \\hideinitializer
@@ -2467,12 +2491,12 @@ class Receiver
   prevent auto-linking to word that is also a documented class or struct. 
 
 <hr>
-\section cmdquot \\\"
+\section cmdquot \\"
 
   \addindex \\\"
   This command writes the \" character to the output. This 
-  character has to be escaped in some cases, because it is used to 
-  prevent auto-linking to word that is also a documented class or struct. 
+  character has to be escaped in some cases, because it is used in pairs
+  to indicate an unformated text fragment.
 
 <hr>
 \htmlonly <center> \endhtmlonly 

doc/config.doc

@@ -115,6 +115,7 @@ followed by the descriptions of the tags grouped by category.
 \refitem cfg_file_version_filter FILE_VERSION_FILTER
 \refitem cfg_filter_patterns FILTER_PATTERNS
 \refitem cfg_filter_source_files FILTER_SOURCE_FILES
+\refitem cfg_force_local_includes FORCE_LOCAL_INCLUDES
 \refitem cfg_formula_fontsize FORMULA_FONTSIZE
 \refitem cfg_full_path_names FULL_PATH_NAMES
 \refitem cfg_generate_autogen_def GENERATE_AUTOGEN_DEF
@@ -152,6 +153,7 @@ followed by the descriptions of the tags grouped by category.
 \refitem cfg_html_header HTML_HEADER
 \refitem cfg_html_output HTML_OUTPUT
 \refitem cfg_html_stylesheet HTML_STYLESHEET
+\refitem cfg_html_timestamp HTML_TIMESTAMP
 \refitem cfg_idl_property_support IDL_PROPERTY_SUPPORT
 \refitem cfg_ignore_prefix IGNORE_PREFIX
 \refitem cfg_image_path IMAGE_PATH
@@ -217,6 +219,7 @@ followed by the descriptions of the tags grouped by category.
 \refitem cfg_search_includes SEARCH_INCLUDES
 \refitem cfg_searchengine SEARCHENGINE
 \refitem cfg_separate_member_pages SEPARATE_MEMBER_PAGES
+\refitem cfg_server_based_search SERVER_BASED_SEARCH
 \refitem cfg_short_names SHORT_NAMES
 \refitem cfg_show_dirs SHOW_DIRECTORIES
 \refitem cfg_show_files SHOW_FILES
@@ -708,10 +711,17 @@ function's detailed documentation block.
 \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
+ If the SHOW_INCLUDE_FILES tag is set to \c 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_force_local_includes
+<dt>\c FORCE_LOCAL_INCLUDES <dd>
+ \addindex FORCE_LOCAL_INCLUDES
+ If the \c FORCE_LOCAL_INCLUDES tag is set to \c YES then Doxygen 
+ will list include files with double quotes in the documentation 
+ rather than with sharp brackets.
+
 \anchor cfg_inline_info
 <dt>\c INLINE_INFO <dd>
  \addindex INLINE_INFO 
@@ -1280,6 +1290,14 @@ FILE_VERSION_INFO = "cleartool desc -fmt \%Vn"
  See also section \ref doxygen_usage for information on how to generate
  the style sheet that doxygen normally uses.
 
+\anchor cfg_html_timestamp
+<dt>\c HTML_TIMESTAMP <dd>
+ \addindex HTML_TIMESTAMP
+ If the \c HTML_TIMESTAMP tag is set to \c YES then the footer of 
+ each generated HTML page will contain the date and time when the page 
+ was generated. Setting this to NO can help when comparing the output of 
+ multiple runs.
+
 \anchor cfg_html_align_members
 <dt>\c HTML_ALIGN_MEMBERS <dd>
  \addindex HTML_ALIGN_MEMBERS
@@ -1440,12 +1458,17 @@ FILE_VERSION_INFO = "cleartool desc -fmt \%Vn"
 \anchor cfg_searchengine
 <dt>\c SEARCHENGINE <dd>
  \addindex SEARCHENGINE
- The \c SEARCHENGINE tag specifies whether or not the HTML output should
- contain a search function. Possible values are \c YES and \c NO. 
- If set to YES, doxygen will produce a search index, and a search box at
- the top of each page (or in the side bar in case GENERATE_TREE is enabled).
- The search engine is implemented using javascript and DHTML and should
- work on any modern browser. 
+
+ When the \c SEARCHENGINE tag is enabled doxygen will generate a search box
+ for the HTML output. The underlying search engine uses javascript 
+ and DHTML and should work on any modern browser. Note that when using
+ HTML help (\ref cfg_generate_htmlhelp "GENERATE_HTMLHELP"), 
+ Qt help (\ref cfg_generate_qhp "GENERATE_QHP"), or docsets
+ (\ref cfg_generate_docset "GENERATE_DOCSET") there is already a search 
+ function so this one should typically be disabled. For large projects 
+ the javascript based search engine can be slow, then enabling 
+ \ref cfg_server_based_search "SERVER_BASED_SEARCH" may provide a 
+ better solution. 
 
  It is possible to search using the keyboard;
  to jump to the search box use access key + S (what the access key is
@@ -1457,29 +1480,17 @@ FILE_VERSION_INFO = "cleartool desc -fmt \%Vn"
  by pressing Shift+cursor down. Also here use the cursor keys to 
  select a filter and enter or escape to activate or cancel the filter option.
 
-<!--
-\anchor cfg_qthelp_file 
-<dt>\c QTHELP_FILE <dd>
- \addindex QTHELP_FILE
-  If the \c GENERATE_HTMLHELP tag is set to \c YES, the \c QTHELP_FILE tag can
-  be used to specify the file name of the resulting .(qch|qhp) file. 
-  You can add a path in front of the file if the result should not be
-  written to the html output directory.
-
-\anchor cfg_qthelp_config 
-<dt>\c QTHELP_CONFIG <dd>
- \addindex QTHELP_CONFIG
-  If \c DOXYGEN2QTHELP_LOC is set, \c QTHELP_CONFIG must specify the file name
-  of a config file to pass to doxygen2qthelp.
-
-\anchor cfg_doxygen2qthelp_loc 
-<dt>\c DOXYGEN2QTHELP_LOC <dd>
- \addindex DOXYGEN2QTHELP_LOC
-  If the \c GENERATE_HTMLHELP tag is set to \c YES, the \c DOXYGEN2QTHELP_LOC tag
-  can be used to specify the location (absolute path including file name) of 
-  the doxygen2qthelp tool. If non-empty doxygen will try to run doxygen2qthelp 
-  on the generated index.hhp.
--->
+\anchor cfg_server_based_search
+<dt>\c SERVER_BASED_SEARCH <dd>
+ \addindex SERVER_BASED_SEARCH
+
+When the SERVER_BASED_SEARCH tag is enabled the search engine will be
+implemented using a PHP enabled web server instead of at the web client
+using Javascript. Doxygen will generate the search PHP script and index 
+file to put on the web server. The advantage of the server
+based approach is that it scales better to large projects and also allows
+full text search. The disadvances is that it is more difficult to setup 
+and does not have live searching capabilities.
 
 \anchor cfg_disable_index
 <dt>\c DISABLE_INDEX <dd>

doc/doxygen_manual.tex

@@ -60,6 +60,7 @@ \chapter{Graphs and diagrams}\label{diagrams}\hypertarget{diagrams}{}\input{diag
 \chapter{Preprocessing}\label{preprocessing}\hypertarget{preprocessing}{}\input{preprocessing}
 \chapter{Automatic link generation}\label{autolink}\hypertarget{autolink}{}\input{autolink}
 \chapter{Output Formats}\label{output}\hypertarget{output}{}\input{output}
+\chapter{Searching}\label{searching}\hypertarget{searching}{}\input{searching}
 \chapter{Customizing the Output}\label{customize}\hypertarget{customize}{}\input{customize}
 \chapter{Custom Commands}\label{custcmd}\hypertarget{custcmd}{}\input{custcmd}
 \chapter{Link to external documentation}\label{external}\hypertarget{external}{}\input{external}
@@ -68,10 +69,10 @@ \chapter{Troubleshooting}\label{trouble}\hypertarget{trouble}{}\input{trouble}
 \part{Reference Manual}
 \chapter{Features}\label{features}\hypertarget{features}{}\input{features}
 \chapter{Doxygen History}\label{history}\hypertarget{history}{}\input{history}
-\chapter{Doxygen usage}\label{doxygen_usage}\hypertarget{doxygen_usage}{}\input{doxygen_usage}
-\chapter{Doxytag usage}\label{doxytag_usage}\hypertarget{doxytag_usage}{}\input{doxytag_usage}
-\chapter{Doxywizard usage}\label{doxywizard_usage}\hypertarget{doxywizard_usage}{}\input{doxywizard_usage}
-\chapter{Installdox usage}\label{installdox_usage}\hypertarget{installdox_usage}{}\input{installdox_usage}
+\chapter{Doxygen usage}\label{doxygen__usage}\hypertarget{doxygen__usage}{}\input{doxygen__usage}
+\chapter{Doxytag usage}\label{doxytag__usage}\hypertarget{doxytag__usage}{}\input{doxytag__usage}
+\chapter{Doxywizard usage}\label{doxywizard__usage}\hypertarget{doxywizard__usage}{}\input{doxywizard__usage}
+\chapter{Installdox usage}\label{installdox__usage}\hypertarget{installdox__usage}{}\input{installdox__usage}
 \chapter{Configuration}\label{config}\hypertarget{config}{}\input{config}
 \chapter{Special Commands}\label{commands}\hypertarget{commands}{}\input{commands}
 \chapter{HTML commands}\label{htmlcmds}\hypertarget{htmlcmds}{}\input{htmlcmds}

doc/index.doc

@@ -74,6 +74,7 @@ The first part forms a user manual:
                  and members in the documentation.
 <li>Section \ref output shows how to generate the various output formats
                  supported by doxygen.
+<li>Section \ref searching shows various ways to search in the HTML documentation.
 <li>Section \ref customize explains how you can customize the output generated
                  by doxygen.
 <li>Section \ref custcmd show how to define and use custom commands in your comments.

doc/language.doc

@@ -68,7 +68,7 @@ when the translator was updated.
     <td>Brazilian Portuguese</td>
     <td>Fabio "FJTC" Jun Takada Chino</td>
     <td>jun-chino at uol dot com dot br</td>
-    <td>1.6.0</td>
+    <td>up-to-date</td>
   </tr>
   <tr bgcolor="#ffffff">
     <td>Catalan</td>
@@ -311,7 +311,7 @@ when the translator was updated.
   \hline
   Arabic & Moaz Reyad & {\tt\tiny [email protected]} & 1.4.6 \\
   \hline
-  Brazilian Portuguese & Fabio "FJTC" Jun Takada Chino & {\tt\tiny [email protected]} & 1.6.0 \\
+  Brazilian Portuguese & Fabio "FJTC" Jun Takada Chino & {\tt\tiny [email protected]} & up-to-date \\
   \hline
   Catalan & Maximiliano Pin & {\tt\tiny [email protected]} & 1.6.0 \\
   ~ & Albert Mora & {\tt\tiny [email protected]} & ~ \\