Extract automatically the log categories, and add them to the documentation

git-svn-id: svn+ssh://scm.gforge.inria.fr/svn/simgrid/simgrid/trunk@911 48e7efb5-ca39-0410-a469-dd3cf9ba447f

diff --git a/doc/.cvsignore b/doc/.cvsignore
index 3ae2926..63ab0b1 100644 (file)
--- a/doc/.cvsignore
+++ b/doc/.cvsignore
@@ -8,3 +8,4 @@ Doxyfile.API
 Doxyfile.Examples
 Doxyfile.main
 api_index.doc
 Doxyfile.Examples
 Doxyfile.main
 api_index.doc

+logcategories.doc

diff --git a/doc/Doxyfile.API.in b/doc/Doxyfile.API.in
index 70047be..20e1114 100644 (file)
--- a/doc/Doxyfile.API.in
+++ b/doc/Doxyfile.API.in
@@ -407,7 +407,8 @@ INPUT                  = @top_srcdir@/include/ \
                          @top_srcdir@/src/gras/Virtu \
                          @top_srcdir@/src/xbt/ \
                          @top_srcdir@/src/modules.doc \
                          @top_srcdir@/src/gras/Virtu \
                          @top_srcdir@/src/xbt/ \
                          @top_srcdir@/src/modules.doc \

-                         ./api_index.doc
+                         ./api_index.doc \
+                         ./logcategories.doc

 
 # If the value of the INPUT tag contains directories, you can use the 
 # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 
 
 # If the value of the INPUT tag contains directories, you can use the 
 # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 46d301f..76ec5c0 100644 (file)
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -7,7 +7,7 @@ DISTCLEANFILES = api_index.doc
 MAINTAINERCLEANFILES = html
 
 if MAINTAINER_MODE
 MAINTAINERCLEANFILES = html
 
 if MAINTAINER_MODE

-html: $(DOCSOURCES) Doxyfile.API  Doxyfile.Examples  Doxyfile.main
+html: $(DOCSOURCES) Doxyfile.API Doxyfile.Examples Doxyfile.main logcategories.doc

        touch api_index.doc
        doxygen Doxyfile.main >/dev/null
        doxygen Doxyfile.API >/dev/null
        touch api_index.doc
        doxygen Doxyfile.main >/dev/null
        doxygen Doxyfile.API >/dev/null


@@ -22,6 +22,14 @@ html: $(DOCSOURCES) Doxyfile.API  Doxyfile.Examples  Doxyfile.main
 #      for i in `find doc/html -name "*.html" -exec grep -l "group_[^_]"  {} \;` ; do tools/fix_doxygen.pl $$i; rm $$i.bak; done
 endif
 
 #      for i in `find doc/html -name "*.html" -exec grep -l "group_[^_]"  {} \;` ; do tools/fix_doxygen.pl $$i; rm $$i.bak; done
 endif
 

+logcategories.doc: $(DOCSOURCES)
+       pwd=`pwd`; rm $$pwd/logcategories.doc; set -e; \
+       echo "/* Generated file, do not edit */"          > $$pwd/logcategories.doc; \
+       echo "/** \addtogroup XBT_log_cats"              >> $$pwd/logcategories.doc; \
+       echo "    @{"                                    >> $$pwd/logcategories.doc; \
+       cd @top_srcdir@/src; ./xbt_log_extract_hierarchy >> $$pwd/logcategories.doc; \
+       echo "@}*/"                                      >> $$pwd/logcategories.doc;
+

 install-data-local: 
        @for file in `find html/ -type d` ; do \
           echo "test -z \"$(prefix)/doc/simgrid/$$file\" || $(mkdir_p) \"$(prefix)/doc/simgrid/$$file\"";\
 install-data-local: 
        @for file in `find html/ -type d` ; do \
           echo "test -z \"$(prefix)/doc/simgrid/$$file\" || $(mkdir_p) \"$(prefix)/doc/simgrid/$$file\"";\