[Plplot-cvs] SF.net SVN: plplot:[11647] trunk/doc/Doxyfile.in

[<ai...@us...>]

Revision: 11647
          http://plplot.svn.sourceforge.net/plplot/?rev=11647&view=rev
Author:   airwin
Date:     2011-03-18 23:23:12 +0000 (Fri, 18 Mar 2011)

Log Message:
-----------
Add lib, include, and bindings directories to the source file search.
The result is a build of much more complete doxygen documentation
for PLplot including more comprehensive cross-references.

Modified Paths:
--------------
    trunk/doc/Doxyfile.in

Modified: trunk/doc/Doxyfile.in
===================================================================
--- trunk/doc/Doxyfile.in	2011-03-18 19:09:22 UTC (rev 11646)
+++ trunk/doc/Doxyfile.in	2011-03-18 23:23:12 UTC (rev 11647)
@@ -31,6 +31,7 @@
 # This could be handy for archiving the generated documentation or
 # if some version control system is used.
 
+# Requires updating for every release.
 PROJECT_NUMBER         = 5.9.7
 
 # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
@@ -581,7 +582,16 @@
 # directories like "/usr/src/myproject". Separate the files or directories
 # with spaces.
 
-INPUT                  = "@CMAKE_SOURCE_DIR@/src"
+INPUT                  = \
+                         "@CMAKE_SOURCE_DIR@/lib" \
+		         "@CMAKE_SOURCE_DIR@/src" \
+                         "@CMAKE_SOURCE_DIR@/drivers" \
+                         "@CMAKE_SOURCE_DIR@/bindings" \
+                         "@CMAKE_SOURCE_DIR@/include" \
+                         "@CMAKE_BINARY_DIR@/config.h" \
+                         "@CMAKE_BINARY_DIR@/lib" \
+                         "@CMAKE_BINARY_DIR@/bindings" \
+                         "@CMAKE_BINARY_DIR@/include" \
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is
@@ -598,6 +608,7 @@
 # *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx
 # *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py *.f90
 
+# Only process C, C++, D, Java, Python, and Fortran files.
 FILE_PATTERNS          = *.c \
                          *.cc \
                          *.cxx \
@@ -605,30 +616,10 @@
                          *.c++ \
                          *.d \
                          *.java \
-                         *.ii \
-                         *.ixx \
-                         *.ipp \
-                         *.i++ \
-                         *.inl \
                          *.h \
-                         *.hh \
-                         *.hxx \
-                         *.hpp \
-                         *.h++ \
-                         *.idl \
-                         *.odl \
-                         *.cs \
-                         *.php \
-                         *.php3 \
-                         *.inc \
-                         *.m \
-                         *.mm \
-                         *.dox \
                          *.py \
                          *.f90 \
                          *.f \
-                         *.vhd \
-                         *.vhdl
 
 # The RECURSIVE tag can be used to turn specify whether or not subdirectories
 # should be searched for input files as well. Possible values are YES and NO.
@@ -640,7 +631,13 @@
 # excluded from the INPUT source files. This way you can easily exclude a
 # subdirectory from a directory tree whose root is specified with the INPUT tag.
 
-EXCLUDE                =
+# These files are Fortran, but their extension confuses doxygen
+# into thinking they are C/C++ headers so exclude them as a workaround.
+EXCLUDE                = \
+                         "@CMAKE_BINARY_DIR@/bindings/f77/plplot_parameters.h" \
+                         "@CMAKE_SOURCE_DIR@/bindings/f95/plplot_parameters.h" \
+                         "@CMAKE_BINARY_DIR@/bindings/f95/plplot_parameters.h" \
+		         
 
 # The EXCLUDE_SYMLINKS tag can be used select whether or not files or
 # directories that are symbolic links (a Unix filesystem feature) are excluded
@@ -654,7 +651,9 @@
 # against the file with absolute path, so to exclude all test directories
 # for example use the pattern */test/*
 
-EXCLUDE_PATTERNS       =
+# Ignore .svn directories in the source tree and CMakeFiles directories
+# in the build tree.
+EXCLUDE_PATTERNS       = */.svn/* */CMakeFiles/*
 
 # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
 # (namespaces, classes, functions, etc.) that should be excluded from the
@@ -1378,7 +1377,9 @@
 # contain include files that are not input files but should be processed by
 # the preprocessor.
 
-INCLUDE_PATH           =
+# Work around a doxygen bug in finding build_tree/bindings/tcl/tclgen_s.h even
+# though the corresponding directory is recursively part of input.
+INCLUDE_PATH           = @CMAKE_BINARY_DIR@/bindings/tcl
 
 # You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
 # patterns (like *.h and *.hpp) to filter out the header-files in the


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.