Module: xenomai-forge
Branch: next
Commit: 383afd709f30a7321f747c6bc3a025707966d8d5
URL:    
http://git.xenomai.org/?p=xenomai-forge.git;a=commit;h=383afd709f30a7321f747c6bc3a025707966d8d5

Author: Philippe Gerum <r...@xenomai.org>
Date:   Wed Jun 11 14:16:04 2014 +0200

doc/doxygen: simplify and sanitize build rules

We keep two generated targets only, folding all APIs into a single
main document:

- html generation for the online manual
- PDF generation for the manual book

Both Cobalt and Mercury cores are documented in the same document,
core-specific APIs are few, as well as variations for common APIs.

The TOC is utterly broken currently, due to contents which moved
around and wrong markup here and there. This will be addressed next.

---

 Makefile.am                                        |    2 +-
 Makefile.in                                        |    2 +-
 configure                                          |   33 ++-
 configure.ac                                       |   18 +-
 doc/Makefile.am                                    |    3 +-
 doc/Makefile.in                                    |    2 +-
 doc/doxygen/Doxyfile-cobalt.in                     |  230 --------------------
 doc/doxygen/Doxyfile-rtdm.in                       |  229 -------------------
 doc/doxygen/Makefile.am                            |   29 +--
 doc/doxygen/Makefile.in                            |   48 ++--
 .../{Doxyfile-common.in => manual-common.conf.in}  |   56 +++++
 doc/doxygen/{Doxyfile.in => manual-html.conf.in}   |   53 +----
 .../{Doxyfile-nucleus.in => manual-pdf.conf.in}    |  174 +++++++--------
 13 files changed, 201 insertions(+), 678 deletions(-)

diff --git a/Makefile.am b/Makefile.am
index cbbbd1a..35ec663 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -11,7 +11,7 @@ SUBDIRS =             \
        utils           \
        demo
 
-if XENO_INSTALL_DOC
+if XENO_RUN_DOC
 SUBDIRS += doc
 endif
 
diff --git a/Makefile.in b/Makefile.in
index 80631d7..04c481d 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -78,7 +78,7 @@ POST_UNINSTALL = :
 build_triplet = @build@
 host_triplet = @host@
 target_triplet = @target@
-@XENO_INSTALL_DOC_TRUE@am__append_1 = doc
+@XENO_RUN_DOC_TRUE@am__append_1 = doc
 subdir = .
 DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \
        $(top_srcdir)/configure $(am__configure_deps) \
diff --git a/configure b/configure
index 1a20b1f..ee39888 100755
--- a/configure
+++ b/configure
@@ -661,6 +661,8 @@ XENO_TLSF_FALSE
 XENO_TLSF_TRUE
 CONFIG_XENO_SHARED_FALSE
 CONFIG_XENO_SHARED_TRUE
+XENO_RUN_DOC_FALSE
+XENO_RUN_DOC_TRUE
 W3M
 A2X
 ASCIIDOC
@@ -13524,11 +13526,24 @@ if test x${XENO_BUILD_DOC} = xy -a x"$W3M" = x ; then
    as_fn_error $? "Missing the w3m tool to build the documentation" "$LINENO" 5
 fi
 
-if test x"$docdir" = x; then
+if test x$docdir = x; then
        docdir=$datadir/doc/$PACKAGE-$VERSION
 fi
 
 
+XENO_RUN_DOC=y
+if test x$XENO_BUILD_DOC = x -a x$XENO_INSTALL_DOC = x; then
+   unset XENO_RUN_DOC
+fi
+ if test "$XENO_RUN_DOC" = y; then
+  XENO_RUN_DOC_TRUE=
+  XENO_RUN_DOC_FALSE='#'
+else
+  XENO_RUN_DOC_TRUE='#'
+  XENO_RUN_DOC_FALSE=
+fi
+
+
 
 ac_fn_c_check_header_mongrel "$LINENO" "valgrind/valgrind.h" 
"ac_cv_header_valgrind_valgrind_h" "$ac_includes_default"
 if test "x$ac_cv_header_valgrind_valgrind_h" = xyes; then :
@@ -14096,8 +14111,8 @@ fi
 ac_config_files="$ac_config_files Makefile config/Makefile scripts/Makefile 
scripts/xeno-config:scripts/xeno-config-$rtcore_type.in scripts/xeno 
lib/Makefile lib/boilerplate/Makefile lib/cobalt/Makefile 
lib/cobalt/arch/Makefile lib/cobalt/arch/arm/Makefile 
lib/cobalt/arch/arm/include/Makefile lib/cobalt/arch/arm/include/asm/Makefile 
lib/cobalt/arch/arm/include/asm/xenomai/Makefile 
lib/cobalt/arch/powerpc/Makefile lib/cobalt/arch/powerpc/include/Makefile 
lib/cobalt/arch/powerpc/include/asm/Makefile 
lib/cobalt/arch/powerpc/include/asm/xenomai/Makefile 
lib/cobalt/arch/blackfin/Makefile lib/cobalt/arch/blackfin/include/Makefile 
lib/cobalt/arch/blackfin/include/asm/Makefile 
lib/cobalt/arch/blackfin/include/asm/xenomai/Makefile 
lib/cobalt/arch/x86/Makefile lib/cobalt/arch/x86/include/Makefile 
lib/cobalt/arch/x86/include/asm/Makefile 
lib/cobalt/arch/x86/include/asm/xenomai/Makefile lib/cobalt/arch/nios2/Makefile 
lib/cobalt/arch/nios2/include/Makefile lib/cobalt/arch/nios2/include/asm/Makef
 ile lib/cobalt/arch/nios2/include/asm/xenomai/Makefile 
lib/cobalt/arch/sh/Makefile lib/cobalt/arch/sh/include/Makefile 
lib/cobalt/arch/sh/include/asm/Makefile 
lib/cobalt/arch/sh/include/asm/xenomai/Makefile lib/copperplate/Makefile 
lib/copperplate/regd/Makefile lib/alchemy/Makefile lib/vxworks/Makefile 
lib/psos/Makefile lib/analogy/Makefile testsuite/Makefile 
testsuite/latency/Makefile testsuite/cyclic/Makefile 
testsuite/switchtest/Makefile testsuite/clocktest/Makefile 
testsuite/unit/Makefile testsuite/xeno-test/Makefile 
testsuite/regression/Makefile testsuite/regression/posix/Makefile 
utils/Makefile utils/can/Makefile utils/analogy/Makefile utils/ps/Makefile 
utils/slackspot/Makefile demo/Makefile demo/posix/Makefile 
demo/posix/cobalt/Makefile demo/alchemy/Makefile demo/alchemy/cobalt/Makefile 
include/Makefile include/nocore/Makefile include/cobalt/uapi/Makefile 
include/cobalt/uapi/asm-generic/Makefile include/cobalt/uapi/kernel/Makefile 
include/cobalt/uapi/rtdm/Makefile include/cob
 alt/Makefile include/cobalt/sys/Makefile include/cobalt/kernel/Makefile 
include/cobalt/kernel/rtdm/Makefile include/cobalt/kernel/rtdm/analogy/Makefile 
include/cobalt/boilerplate/Makefile include/rtdm/Makefile 
include/rtdm/uapi/Makefile include/mercury/Makefile 
include/mercury/boilerplate/Makefile include/boilerplate/Makefile 
include/copperplate/Makefile include/alchemy/Makefile include/vxworks/Makefile 
include/psos/Makefile"
 
 
-if test \! x$XENO_INSTALL_DOC = x ; then
-      ac_config_files="$ac_config_files doc/Makefile doc/man/Makefile 
doc/doxygen/Makefile doc/doxygen/Doxyfile-common doc/doxygen/Doxyfile 
doc/doxygen/Doxyfile-nucleus doc/doxygen/Doxyfile-cobalt 
doc/doxygen/Doxyfile-rtdm doc/asciidoc/Makefile"
+if test \! x$XENO_RUN_DOC = x ; then
+      ac_config_files="$ac_config_files doc/Makefile doc/man/Makefile 
doc/doxygen/Makefile doc/doxygen/manual-common.conf 
doc/doxygen/manual-html.conf doc/doxygen/manual-pdf.conf doc/asciidoc/Makefile"
 
 fi
 
@@ -14278,6 +14293,10 @@ if test -z "${XENO_INSTALL_DOC_TRUE}" && test -z 
"${XENO_INSTALL_DOC_FALSE}"; th
   as_fn_error $? "conditional \"XENO_INSTALL_DOC\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
+if test -z "${XENO_RUN_DOC_TRUE}" && test -z "${XENO_RUN_DOC_FALSE}"; then
+  as_fn_error $? "conditional \"XENO_RUN_DOC\" was never defined.
+Usually this means the macro was only invoked conditionally." "$LINENO" 5
+fi
 if test -z "${CONFIG_XENO_SHARED_TRUE}" && test -z 
"${CONFIG_XENO_SHARED_FALSE}"; then
   as_fn_error $? "conditional \"CONFIG_XENO_SHARED\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
@@ -15240,11 +15259,9 @@ do
     "doc/Makefile") CONFIG_FILES="$CONFIG_FILES doc/Makefile" ;;
     "doc/man/Makefile") CONFIG_FILES="$CONFIG_FILES doc/man/Makefile" ;;
     "doc/doxygen/Makefile") CONFIG_FILES="$CONFIG_FILES doc/doxygen/Makefile" 
;;
-    "doc/doxygen/Doxyfile-common") CONFIG_FILES="$CONFIG_FILES 
doc/doxygen/Doxyfile-common" ;;
-    "doc/doxygen/Doxyfile") CONFIG_FILES="$CONFIG_FILES doc/doxygen/Doxyfile" 
;;
-    "doc/doxygen/Doxyfile-nucleus") CONFIG_FILES="$CONFIG_FILES 
doc/doxygen/Doxyfile-nucleus" ;;
-    "doc/doxygen/Doxyfile-cobalt") CONFIG_FILES="$CONFIG_FILES 
doc/doxygen/Doxyfile-cobalt" ;;
-    "doc/doxygen/Doxyfile-rtdm") CONFIG_FILES="$CONFIG_FILES 
doc/doxygen/Doxyfile-rtdm" ;;
+    "doc/doxygen/manual-common.conf") CONFIG_FILES="$CONFIG_FILES 
doc/doxygen/manual-common.conf" ;;
+    "doc/doxygen/manual-html.conf") CONFIG_FILES="$CONFIG_FILES 
doc/doxygen/manual-html.conf" ;;
+    "doc/doxygen/manual-pdf.conf") CONFIG_FILES="$CONFIG_FILES 
doc/doxygen/manual-pdf.conf" ;;
     "doc/asciidoc/Makefile") CONFIG_FILES="$CONFIG_FILES 
doc/asciidoc/Makefile" ;;
 
   *) as_fn_error $? "invalid argument: \`$ac_config_target'" "$LINENO" 5;;
diff --git a/configure.ac b/configure.ac
index 6ba6e96..a6e0cc1 100644
--- a/configure.ac
+++ b/configure.ac
@@ -447,11 +447,17 @@ if test x${XENO_BUILD_DOC} = xy -a x"$W3M" = x ; then
    AC_MSG_ERROR([Missing the w3m tool to build the documentation])
 fi
 
-if test x"$docdir" = x; then
+if test x$docdir = x; then
        docdir=$datadir/doc/$PACKAGE-$VERSION
 fi
 AC_SUBST(docdir)
 
+XENO_RUN_DOC=y
+if test x$XENO_BUILD_DOC = x -a x$XENO_INSTALL_DOC = x; then
+   unset XENO_RUN_DOC
+fi
+AM_CONDITIONAL(XENO_RUN_DOC,[test "$XENO_RUN_DOC" = y])
+
 dnl Check for Valgrind client API support.
 dnl Some GCC releases produce broken assembly code for Valgrind
 dnl client calls, so we check this too. --disable-valgrind-client
@@ -870,16 +876,14 @@ AC_CONFIG_FILES([ \
        include/psos/Makefile \
        ])
 
-if test \! x$XENO_INSTALL_DOC = x ; then
+if test \! x$XENO_RUN_DOC = x ; then
       AC_CONFIG_FILES([ \
        doc/Makefile \
        doc/man/Makefile \
        doc/doxygen/Makefile \
-       doc/doxygen/Doxyfile-common \
-       doc/doxygen/Doxyfile \
-       doc/doxygen/Doxyfile-nucleus \
-       doc/doxygen/Doxyfile-cobalt \
-       doc/doxygen/Doxyfile-rtdm \
+       doc/doxygen/manual-common.conf \
+       doc/doxygen/manual-html.conf \
+       doc/doxygen/manual-pdf.conf \
        doc/asciidoc/Makefile \
       ])
 fi
diff --git a/doc/Makefile.am b/doc/Makefile.am
index b19c09e..d54544d 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,4 +1,4 @@
-SUBDIRS=asciidoc doxygen man
+SUBDIRS=doxygen asciidoc man
 
 GENERATE_DOC=$(top_srcdir)/scripts/maint/generate-doc
 
@@ -8,3 +8,4 @@ generate-doc:
        else \
                srcdir=$(srcdir) $(GENERATE_DOC) ; \
        fi
+
diff --git a/doc/Makefile.in b/doc/Makefile.in
index 6c02101..ceb556e 100644
--- a/doc/Makefile.in
+++ b/doc/Makefile.in
@@ -338,7 +338,7 @@ target_vendor = @target_vendor@
 top_build_prefix = @top_build_prefix@
 top_builddir = @top_builddir@
 top_srcdir = @top_srcdir@
-SUBDIRS = asciidoc doxygen man
+SUBDIRS = doxygen asciidoc man
 GENERATE_DOC = $(top_srcdir)/scripts/maint/generate-doc
 all: all-recursive
 
diff --git a/doc/doxygen/Doxyfile-cobalt.in b/doc/doxygen/Doxyfile-cobalt.in
deleted file mode 100644
index 29670e8..0000000
--- a/doc/doxygen/Doxyfile-cobalt.in
+++ /dev/null
@@ -1,230 +0,0 @@
-@INCLUDE = Doxyfile-common
-
-# Doxyfile 1.3.4
-
-# The PROJECT_NAME tag is a single word (or a sequence of words surrounded 
-# by quotes) that should identify the project.
-
-PROJECT_NAME           = "Xenomai Cobalt interface"
-
-# The INPUT tag can be used to specify the files and/or directories that 
contain 
-# documented source files. You may enter file names like "myfile.cpp" or 
-# directories like "/usr/src/myproject". Separate the files or directories 
-# with spaces.
-
-INPUT                  = \
-        @top_srcdir@/include/cobalt \
-        @top_srcdir@/kernel/cobalt \
-       @top_srcdir@/include/rtdm \
-        @top_srcdir@/doc/doxygen
-
-# The EXAMPLE_PATH tag can be used to specify one or more files or 
-# directories that contain example code fragments that are included (see 
-# the \include command).
-
-EXAMPLE_PATH           =
-
-#---------------------------------------------------------------------------
-# configuration options related to the HTML output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_HTML tag is set to YES (the default) Doxygen will 
-# generate HTML output.
-
-GENERATE_HTML          = NO
-
-# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. 
-# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
-# put in front of it. If left blank `html' will be used as the default path.
-
-HTML_OUTPUT            = api
-
-# The HTML_FILE_EXTENSION tag can be used to specify the file extension for 
-# each generated HTML page (for example: .htm,.php,.asp). If it is left blank 
-# doxygen will generate files with .html extension.
-
-HTML_FILE_EXTENSION    = .html
-
-# The HTML_HEADER tag can be used to specify a personal HTML header for 
-# each generated HTML page. If it is left blank doxygen will generate a 
-# standard header.
-
-HTML_HEADER            = 
-
-# The HTML_FOOTER tag can be used to specify a personal HTML footer for 
-# each generated HTML page. If it is left blank doxygen will generate a 
-# standard footer.
-
-HTML_FOOTER            = 
-
-# The HTML_STYLESHEET tag can be used to specify a user-defined cascading 
-# style sheet that is used by each HTML page. It can be used to 
-# fine-tune the look of the HTML output. If the tag is left blank doxygen 
-# will generate a default style sheet
-
-HTML_STYLESHEET        = 
-
-# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, 
-# files or namespaces will be aligned in HTML using tables. If set to 
-# NO a bullet list will be used.
-
-HTML_ALIGN_MEMBERS     = YES
-
-# If the GENERATE_HTMLHELP tag is set to YES, additional index files 
-# will be generated that can be used as input for tools like the 
-# Microsoft HTML help workshop to generate a compressed HTML help file (.chm) 
-# of the generated HTML documentation.
-
-GENERATE_HTMLHELP      = NO
-
-# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can 
-# be used to specify the file name of the resulting .chm file. You 
-# can add a path in front of the file if the result should not be 
-# written to the html output dir.
-
-CHM_FILE               = 
-
-# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can 
-# be used to specify the location (absolute path including file name) of 
-# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run 
-# the HTML help compiler on the generated index.hhp.
-
-HHC_LOCATION           = 
-
-# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag 
-# controls if a separate .chi index file is generated (YES) or that 
-# it should be included in the master .chm file (NO).
-
-GENERATE_CHI           = NO
-
-# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag 
-# controls whether a binary table of contents is generated (YES) or a 
-# normal table of contents (NO) in the .chm file.
-
-BINARY_TOC             = NO
-
-# The TOC_EXPAND flag can be set to YES to add extra items for group members 
-# to the contents of the HTML help documentation and to the tree view.
-
-TOC_EXPAND             = NO
-
-# The DISABLE_INDEX tag can be used to turn on/off the condensed index at 
-# top of each HTML page. The value NO (the default) enables the index and 
-# the value YES disables it.
-
-DISABLE_INDEX          = NO
-
-# This tag can be used to set the number of enum values (range [1..20]) 
-# that doxygen will group on one line in the generated HTML documentation.
-
-ENUM_VALUES_PER_LINE   = 4
-
-# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be
-# generated containing a tree-like index structure (just like the one that 
-# is generated for HTML Help). For this to work a browser that supports 
-# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, 
-# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are 
-# probably better off using the HTML help feature.
-
-GENERATE_TREEVIEW      = YES
-
-# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be 
-# used to set the initial width (in pixels) of the frame in which the tree 
-# is shown.
-
-TREEVIEW_WIDTH         = 250
-
-#---------------------------------------------------------------------------
-# Configuration::addtions related to the search engine   
-#---------------------------------------------------------------------------
-
-# The SEARCHENGINE tag specifies whether or not a search engine should be 
-# used. If set to NO the values of all tags below this one will be ignored.
-
-SEARCHENGINE           = NO
-
-#---------------------------------------------------------------------------
-# configuration options related to the LaTeX output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will 
-# generate Latex output.
-
-GENERATE_LATEX         = YES
-
-# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. 
-# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
-# put in front of it. If left blank `latex' will be used as the default path.
-
-LATEX_OUTPUT           = latex-cobalt
-
-# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be 
-# invoked. If left blank `latex' will be used as the default command name.
-
-LATEX_CMD_NAME         = latex
-
-# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to 
-# generate index for LaTeX. If left blank `makeindex' will be used as the 
-# default command name.
-
-MAKEINDEX_CMD_NAME     = makeindex
-
-# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact 
-# LaTeX documents. This may be useful for small projects and may help to 
-# save some trees in general.
-
-COMPACT_LATEX          = NO
-
-# The PAPER_TYPE tag can be used to set the paper type that is used 
-# by the printer. Possible values are: a4, a4wide, letter, legal and 
-# executive. If left blank a4wide will be used.
-
-PAPER_TYPE             = a4wide
-
-# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX 
-# packages that should be included in the LaTeX output.
-
-EXTRA_PACKAGES         = pxfonts
-
-# The LATEX_HEADER tag can be used to specify a personal LaTeX header for 
-# the generated latex document. The header should contain everything until 
-# the first chapter. If it is left blank doxygen will generate a 
-# standard header. Notice: only use this tag if you know what you are doing!
-
-LATEX_HEADER           = 
-
-# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated 
-# is prepared for conversion to pdf (using ps2pdf). The pdf file will 
-# contain links (just like the HTML output) instead of page references 
-# This makes the output suitable for online browsing using a pdf viewer.
-
-PDF_HYPERLINKS         = YES
-
-# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of 
-# plain latex in the generated Makefile. Set this option to YES to get a 
-# higher quality PDF documentation.
-
-USE_PDFLATEX           = YES
-
-# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. 
-# command to the generated LaTeX files. This will instruct LaTeX to keep 
-# running if errors occur, instead of asking the user for help. 
-# This option is also used when generating formulas in HTML.
-
-LATEX_BATCHMODE        = @LATEX_BATCHMODE@
-
-# If LATEX_HIDE_INDICES is set to YES then doxygen will not 
-# include the index chapters (such as File Index, Compound Index, etc.) 
-# in the output.
-
-LATEX_HIDE_INDICES     = NO
-
-#---------------------------------------------------------------------------
-# Configuration options related to the preprocessor   
-#---------------------------------------------------------------------------
-
-# The INCLUDE_PATH tag can be used to specify one or more directories that 
-# contain include files that are not input files but should be processed by 
-# the preprocessor.
-
-INCLUDE_PATH           =
diff --git a/doc/doxygen/Doxyfile-rtdm.in b/doc/doxygen/Doxyfile-rtdm.in
deleted file mode 100644
index e468a19..0000000
--- a/doc/doxygen/Doxyfile-rtdm.in
+++ /dev/null
@@ -1,229 +0,0 @@
-@INCLUDE = Doxyfile-common
-
-# Doxyfile 1.3.4
-
-# The PROJECT_NAME tag is a single word (or a sequence of words surrounded 
-# by quotes) that should identify the project.
-
-PROJECT_NAME           = "Xenomai RTDM skin API"
-
-# The INPUT tag can be used to specify the files and/or directories that 
contain 
-# documented source files. You may enter file names like "myfile.cpp" or 
-# directories like "/usr/src/myproject". Separate the files or directories 
-# with spaces.
-
-INPUT                  = \
-        @top_srcdir@/include/rtdm \
-        @top_srcdir@/kernel/cobalt/rtdm \
-        @top_srcdir@/doc/doxygen
-
-# The EXAMPLE_PATH tag can be used to specify one or more files or 
-# directories that contain example code fragments that are included (see 
-# the \include command).
-
-EXAMPLE_PATH           = @top_srcdir@/utils
-
-#---------------------------------------------------------------------------
-# configuration options related to the HTML output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_HTML tag is set to YES (the default) Doxygen will 
-# generate HTML output.
-
-GENERATE_HTML          = NO
-
-# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. 
-# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
-# put in front of it. If left blank `html' will be used as the default path.
-
-HTML_OUTPUT            = api
-
-# The HTML_FILE_EXTENSION tag can be used to specify the file extension for 
-# each generated HTML page (for example: .htm,.php,.asp). If it is left blank 
-# doxygen will generate files with .html extension.
-
-HTML_FILE_EXTENSION    = .html
-
-# The HTML_HEADER tag can be used to specify a personal HTML header for 
-# each generated HTML page. If it is left blank doxygen will generate a 
-# standard header.
-
-HTML_HEADER            = 
-
-# The HTML_FOOTER tag can be used to specify a personal HTML footer for 
-# each generated HTML page. If it is left blank doxygen will generate a 
-# standard footer.
-
-HTML_FOOTER            = 
-
-# The HTML_STYLESHEET tag can be used to specify a user-defined cascading 
-# style sheet that is used by each HTML page. It can be used to 
-# fine-tune the look of the HTML output. If the tag is left blank doxygen 
-# will generate a default style sheet
-
-HTML_STYLESHEET        = 
-
-# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, 
-# files or namespaces will be aligned in HTML using tables. If set to 
-# NO a bullet list will be used.
-
-HTML_ALIGN_MEMBERS     = YES
-
-# If the GENERATE_HTMLHELP tag is set to YES, additional index files 
-# will be generated that can be used as input for tools like the 
-# Microsoft HTML help workshop to generate a compressed HTML help file (.chm) 
-# of the generated HTML documentation.
-
-GENERATE_HTMLHELP      = NO
-
-# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can 
-# be used to specify the file name of the resulting .chm file. You 
-# can add a path in front of the file if the result should not be 
-# written to the html output dir.
-
-CHM_FILE               = 
-
-# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can 
-# be used to specify the location (absolute path including file name) of 
-# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run 
-# the HTML help compiler on the generated index.hhp.
-
-HHC_LOCATION           = 
-
-# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag 
-# controls if a separate .chi index file is generated (YES) or that 
-# it should be included in the master .chm file (NO).
-
-GENERATE_CHI           = NO
-
-# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag 
-# controls whether a binary table of contents is generated (YES) or a 
-# normal table of contents (NO) in the .chm file.
-
-BINARY_TOC             = NO
-
-# The TOC_EXPAND flag can be set to YES to add extra items for group members 
-# to the contents of the HTML help documentation and to the tree view.
-
-TOC_EXPAND             = NO
-
-# The DISABLE_INDEX tag can be used to turn on/off the condensed index at 
-# top of each HTML page. The value NO (the default) enables the index and 
-# the value YES disables it.
-
-DISABLE_INDEX          = NO
-
-# This tag can be used to set the number of enum values (range [1..20]) 
-# that doxygen will group on one line in the generated HTML documentation.
-
-ENUM_VALUES_PER_LINE   = 4
-
-# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be
-# generated containing a tree-like index structure (just like the one that 
-# is generated for HTML Help). For this to work a browser that supports 
-# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, 
-# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are 
-# probably better off using the HTML help feature.
-
-GENERATE_TREEVIEW      = YES
-
-# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be 
-# used to set the initial width (in pixels) of the frame in which the tree 
-# is shown.
-
-TREEVIEW_WIDTH         = 250
-
-#---------------------------------------------------------------------------
-# Configuration::addtions related to the search engine   
-#---------------------------------------------------------------------------
-
-# The SEARCHENGINE tag specifies whether or not a search engine should be 
-# used. If set to NO the values of all tags below this one will be ignored.
-
-SEARCHENGINE           = NO
-
-#---------------------------------------------------------------------------
-# configuration options related to the LaTeX output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will 
-# generate Latex output.
-
-GENERATE_LATEX         = YES
-
-# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. 
-# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
-# put in front of it. If left blank `latex' will be used as the default path.
-
-LATEX_OUTPUT           = latex-rtdm
-
-# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be 
-# invoked. If left blank `latex' will be used as the default command name.
-
-LATEX_CMD_NAME         = latex
-
-# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to 
-# generate index for LaTeX. If left blank `makeindex' will be used as the 
-# default command name.
-
-MAKEINDEX_CMD_NAME     = makeindex
-
-# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact 
-# LaTeX documents. This may be useful for small projects and may help to 
-# save some trees in general.
-
-COMPACT_LATEX          = NO
-
-# The PAPER_TYPE tag can be used to set the paper type that is used 
-# by the printer. Possible values are: a4, a4wide, letter, legal and 
-# executive. If left blank a4wide will be used.
-
-PAPER_TYPE             = a4wide
-
-# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX 
-# packages that should be included in the LaTeX output.
-
-EXTRA_PACKAGES         = pxfonts
-
-# The LATEX_HEADER tag can be used to specify a personal LaTeX header for 
-# the generated latex document. The header should contain everything until 
-# the first chapter. If it is left blank doxygen will generate a 
-# standard header. Notice: only use this tag if you know what you are doing!
-
-LATEX_HEADER           = 
-
-# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated 
-# is prepared for conversion to pdf (using ps2pdf). The pdf file will 
-# contain links (just like the HTML output) instead of page references 
-# This makes the output suitable for online browsing using a pdf viewer.
-
-PDF_HYPERLINKS         = YES
-
-# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of 
-# plain latex in the generated Makefile. Set this option to YES to get a 
-# higher quality PDF documentation.
-
-USE_PDFLATEX           = YES
-
-# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. 
-# command to the generated LaTeX files. This will instruct LaTeX to keep 
-# running if errors occur, instead of asking the user for help. 
-# This option is also used when generating formulas in HTML.
-
-LATEX_BATCHMODE        = @LATEX_BATCHMODE@
-
-# If LATEX_HIDE_INDICES is set to YES then doxygen will not 
-# include the index chapters (such as File Index, Compound Index, etc.) 
-# in the output.
-
-LATEX_HIDE_INDICES     = NO
-
-#---------------------------------------------------------------------------
-# Configuration options related to the preprocessor   
-#---------------------------------------------------------------------------
-
-# The INCLUDE_PATH tag can be used to specify one or more directories that 
-# contain include files that are not input files but should be processed by 
-# the preprocessor.
-
-INCLUDE_PATH           =
diff --git a/doc/doxygen/Makefile.am b/doc/doxygen/Makefile.am
index 716808e..5f4273c 100644
--- a/doc/doxygen/Makefile.am
+++ b/doc/doxygen/Makefile.am
@@ -1,9 +1,6 @@
-HTML_DOCS=api api/search
-PDF_DOCS= nucleus-api.pdf cobalt-api.pdf rtdm-api.pdf
-
-EXTRA_DIST = \
-       Doxyfile.in Doxyfile-common.in Doxyfile-nucleus.in \
-       Doxyfile-cobalt.in Doxyfile-rtdm.in
+HTML_DOCS = manual-html manual-html/search
+PDF_DOCS  = manual.pdf
+EXTRA_DIST = manual-common.conf.in manual-html.conf.in manual-pdf.conf.in
 
 if !XENO_BUILD_DOC
 HTML_DOCSDIR = $(srcdir)/../generated/html/
@@ -12,26 +9,22 @@ else
 HTML_DOCSDIR = ./
 PDF_DOCSDIR = ./
 
-# Doxygen documentation
-api: doxygen-api
-
 all-local: $(HTML_DOCS) $(PDF_DOCS)
 
-doxygen-api: Doxyfile
-       $(DOXYGEN) $(DOXYDOC_OPTS)
+manual-html:
+       $(DOXYGEN) $@.conf
 
-%-api.pdf: FORCE
-       $(MAKE) Doxyfile-$*
-       $(DOXYGEN) $(DOXYDOC_OPTS) Doxyfile-$*
-       $(MAKE) -C latex-$* refman.pdf
-       mv latex-$*/refman.pdf $@
+%.pdf: FORCE
+       $(DOXYGEN) $*-pdf.conf
+       $(MAKE) -C $*-latex refman.pdf
+       mv $*-latex/refman.pdf $@
 
 distclean-local:
-       for dir in $(HTML_DOCS) latex-*; do \
+       for dir in $(HTML_DOCS) *-latex; do \
            if test -d $$dir ; then $(RM) -R $$dir ; fi ; \
        done
 
-.PHONY: doxygen-api FORCE
+.PHONY: manual-html FORCE
 
 .DELETE_ON_ERROR:
 
diff --git a/doc/doxygen/Makefile.in b/doc/doxygen/Makefile.in
index 30d74e3..a073479 100644
--- a/doc/doxygen/Makefile.in
+++ b/doc/doxygen/Makefile.in
@@ -80,9 +80,8 @@ host_triplet = @host@
 target_triplet = @target@
 DIST_COMMON = $(top_srcdir)/doc/install-dist.rules \
        $(srcdir)/Makefile.in $(srcdir)/Makefile.am \
-       $(srcdir)/Doxyfile-common.in $(srcdir)/Doxyfile.in \
-       $(srcdir)/Doxyfile-nucleus.in $(srcdir)/Doxyfile-cobalt.in \
-       $(srcdir)/Doxyfile-rtdm.in
+       $(srcdir)/manual-common.conf.in $(srcdir)/manual-html.conf.in \
+       $(srcdir)/manual-pdf.conf.in
 subdir = doc/doxygen
 ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
 am__aclocal_m4_deps = $(top_srcdir)/config/ac_prog_cc_for_build.m4 \
@@ -96,8 +95,8 @@ am__configure_deps = $(am__aclocal_m4_deps) 
$(CONFIGURE_DEPENDENCIES) \
        $(ACLOCAL_M4)
 mkinstalldirs = $(install_sh) -d
 CONFIG_HEADER = $(top_builddir)/include/xeno_config.h
-CONFIG_CLEAN_FILES = Doxyfile-common Doxyfile Doxyfile-nucleus \
-       Doxyfile-cobalt Doxyfile-rtdm
+CONFIG_CLEAN_FILES = manual-common.conf manual-html.conf \
+       manual-pdf.conf
 CONFIG_CLEAN_VPATH_FILES =
 AM_V_P = $(am__v_P_@AM_V@)
 am__v_P_ = $(am__v_P_@AM_DEFAULT_V@)
@@ -296,12 +295,9 @@ target_vendor = @target_vendor@
 top_build_prefix = @top_build_prefix@
 top_builddir = @top_builddir@
 top_srcdir = @top_srcdir@
-HTML_DOCS = api api/search
-PDF_DOCS = nucleus-api.pdf cobalt-api.pdf rtdm-api.pdf
-EXTRA_DIST = \
-       Doxyfile.in Doxyfile-common.in Doxyfile-nucleus.in \
-       Doxyfile-cobalt.in Doxyfile-rtdm.in
-
+HTML_DOCS = manual-html manual-html/search
+PDF_DOCS = manual.pdf
+EXTRA_DIST = manual-common.conf.in manual-html.conf.in manual-pdf.conf.in
 @XENO_BUILD_DOC_FALSE@HTML_DOCSDIR = $(srcdir)/../generated/html/
 @XENO_BUILD_DOC_TRUE@HTML_DOCSDIR = ./
 @XENO_BUILD_DOC_FALSE@PDF_DOCSDIR = $(srcdir)/../generated/pdf/
@@ -342,15 +338,11 @@ $(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ 
$(am__configure_deps)
 $(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps)
        cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
 $(am__aclocal_m4_deps):
-Doxyfile-common: $(top_builddir)/config.status $(srcdir)/Doxyfile-common.in
-       cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
-Doxyfile: $(top_builddir)/config.status $(srcdir)/Doxyfile.in
+manual-common.conf: $(top_builddir)/config.status 
$(srcdir)/manual-common.conf.in
        cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
-Doxyfile-nucleus: $(top_builddir)/config.status $(srcdir)/Doxyfile-nucleus.in
+manual-html.conf: $(top_builddir)/config.status $(srcdir)/manual-html.conf.in
        cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
-Doxyfile-cobalt: $(top_builddir)/config.status $(srcdir)/Doxyfile-cobalt.in
-       cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
-Doxyfile-rtdm: $(top_builddir)/config.status $(srcdir)/Doxyfile-rtdm.in
+manual-pdf.conf: $(top_builddir)/config.status $(srcdir)/manual-pdf.conf.in
        cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@
 
 mostlyclean-libtool:
@@ -516,26 +508,22 @@ uninstall-am: uninstall-local
        tags-am uninstall uninstall-am uninstall-local
 
 
-# Doxygen documentation
-@XENO_BUILD_DOC_TRUE@api: doxygen-api
-
 @XENO_BUILD_DOC_TRUE@all-local: $(HTML_DOCS) $(PDF_DOCS)
 
-@XENO_BUILD_DOC_TRUE@doxygen-api: Doxyfile
-@XENO_BUILD_DOC_TRUE@  $(DOXYGEN) $(DOXYDOC_OPTS)
+@XENO_BUILD_DOC_TRUE@manual-html:
+@XENO_BUILD_DOC_TRUE@  $(DOXYGEN) $@.conf
 
-@XENO_BUILD_DOC_TRUE@%-api.pdf: FORCE
-@XENO_BUILD_DOC_TRUE@  $(MAKE) Doxyfile-$*
-@XENO_BUILD_DOC_TRUE@  $(DOXYGEN) $(DOXYDOC_OPTS) Doxyfile-$*
-@XENO_BUILD_DOC_TRUE@  $(MAKE) -C latex-$* refman.pdf
-@XENO_BUILD_DOC_TRUE@  mv latex-$*/refman.pdf $@
+@XENO_BUILD_DOC_TRUE@%.pdf: FORCE
+@XENO_BUILD_DOC_TRUE@  $(DOXYGEN) $*-pdf.conf
+@XENO_BUILD_DOC_TRUE@  $(MAKE) -C $*-latex refman.pdf
+@XENO_BUILD_DOC_TRUE@  mv $*-latex/refman.pdf $@
 
 @XENO_BUILD_DOC_TRUE@distclean-local:
-@XENO_BUILD_DOC_TRUE@  for dir in $(HTML_DOCS) latex-*; do \
+@XENO_BUILD_DOC_TRUE@  for dir in $(HTML_DOCS) *-latex; do \
 @XENO_BUILD_DOC_TRUE@      if test -d $$dir ; then $(RM) -R $$dir ; fi ; \
 @XENO_BUILD_DOC_TRUE@  done
 
-@XENO_BUILD_DOC_TRUE@.PHONY: doxygen-api FORCE
+@XENO_BUILD_DOC_TRUE@.PHONY: manual-html FORCE
 
 @XENO_BUILD_DOC_TRUE@.DELETE_ON_ERROR:
 
diff --git a/doc/doxygen/Doxyfile-common.in b/doc/doxygen/manual-common.conf.in
similarity index 93%
rename from doc/doxygen/Doxyfile-common.in
rename to doc/doxygen/manual-common.conf.in
index 8da171a..6512361 100644
--- a/doc/doxygen/Doxyfile-common.in
+++ b/doc/doxygen/manual-common.conf.in
@@ -14,6 +14,11 @@
 # Project related configuration options
 #---------------------------------------------------------------------------
 
+# The PROJECT_NAME tag is a single word (or a sequence of words surrounded
+# by quotes) that should identify the project.
+
+PROJECT_NAME           = "Xenomai"
+
 # The PROJECT_NUMBER tag can be used to enter a project or revision number. 
 # This could be handy for archiving the generated documentation or 
 # if some version control system is used.
@@ -848,3 +853,54 @@ GENERATE_LEGEND        = YES
 # the various graphs.
 
 DOT_CLEANUP            = YES
+
+# The INPUT tag can be used to specify the files and/or directories that 
contain
+# documented source files. You may enter file names like "myfile.cpp" or
+# directories like "/usr/src/myproject". Separate the files or directories
+# with spaces.
+
+INPUT                  =                                               \
+                      @top_srcdir@/include/cobalt                      \
+                      @top_srcdir@/include/cobalt/kernel               \
+                      @top_srcdir@/include/cobalt/kernel/rtdm          \
+                      @top_srcdir@/include/cobalt/kernel/rtdm/analogy  \
+                      @top_srcdir@/include/cobalt/sys                  \
+                      @top_srcdir@/include/cobalt/uapi                 \
+                      @top_srcdir@/include/cobalt/uapi/kernel          \
+                      @top_srcdir@/include/cobalt/uapi/rtdm            \
+                      @top_srcdir@/include/boilerplate                 \
+                      @top_srcdir@/include/copperplate                 \
+                      @top_srcdir@/include/alchemy                     \
+                      @top_srcdir@/include/vxworks                     \
+                      @top_srcdir@/include/psos                        \
+                      @top_srcdir@/include/rtdm                        \
+                      @top_srcdir@/include/rtdm/uapi                   \
+                      @top_srcdir@/kernel/cobalt                       \
+                      @top_srcdir@/kernel/cobalt/arch/arm              \
+                      @top_srcdir@/kernel/cobalt/arch/powerpc          \
+                      @top_srcdir@/kernel/cobalt/arch/x86              \
+                      @top_srcdir@/kernel/cobalt/arch/blackfin         \
+                      @top_srcdir@/kernel/cobalt/arch/nios2            \
+                      @top_srcdir@/kernel/cobalt/arch/sh               \
+                      @top_srcdir@/kernel/cobalt/rtdm                  \
+                      @top_srcdir@/kernel/cobalt/posix                 \
+                      @top_srcdir@/kernel/drivers/ipc                  \
+                      @top_srcdir@/kernel/drivers/serial               \
+                      @top_srcdir@/kernel/drivers/analogy              \
+                      @top_srcdir@/kernel/drivers/can                  \
+                      @top_srcdir@/kernel/drivers/testing              \
+                      @top_srcdir@/lib/boilerplate                     \
+                      @top_srcdir@/lib/cobalt                          \
+                      @top_srcdir@/lib/analogy                         \
+                      @top_srcdir@/lib/copperplate                     \
+                      @top_srcdir@/lib/alchemy                         \
+                      @top_srcdir@/lib/psos                            \
+                      @top_srcdir@/lib/vxworks
+
+# The EXAMPLE_PATH tag can be used to specify one or more files or
+# directories that contain example code fragments that are included (see
+# the \include command).
+
+EXAMPLE_PATH           =                       \
+                      @top_srcdir@/demo/posix  \
+                      @top_srcdir@/demo/alchemy
diff --git a/doc/doxygen/Doxyfile.in b/doc/doxygen/manual-html.conf.in
similarity index 81%
rename from doc/doxygen/Doxyfile.in
rename to doc/doxygen/manual-html.conf.in
index d21ac2c..59f62b5 100644
--- a/doc/doxygen/Doxyfile.in
+++ b/doc/doxygen/manual-html.conf.in
@@ -1,47 +1,4 @@
-@INCLUDE = Doxyfile-common
-
-# Doxyfile 1.3.4
-
-# The PROJECT_NAME tag is a single word (or a sequence of words surrounded
-# by quotes) that should identify the project.
-
-PROJECT_NAME           = "Xenomai"
-
-
-#---------------------------------------------------------------------------
-# configuration options related to the input files
-#---------------------------------------------------------------------------
-
-# The INPUT tag can be used to specify the files and/or directories that 
contain
-# documented source files. You may enter file names like "myfile.cpp" or
-# directories like "/usr/src/myproject". Separate the files or directories
-# with spaces.
-
-INPUT                  = \
-       @top_srcdir@/include/cobalt/uapi \
-       @top_srcdir@/include/cobalt/kernel \
-       @top_srcdir@/kernel/cobalt \
-       @top_srcdir@/include/nocore \
-       @top_srcdir@/include/boilerplate \
-       @top_srcdir@/include/copperplate \
-       @top_srcdir@/include/alchemy \
-       @top_srcdir@/include/rtdm \
-       @top_srcdir@/include/analogy \
-       @top_srcdir@/lib/copperplate \
-       @top_srcdir@/lib/alchemy \
-       @top_srcdir@/lib/analogy \
-       @top_srcdir@/kernel/drivers/analogy \
-       @top_srcdir@/doc/doxygen
-
-# The EXAMPLE_PATH tag can be used to specify one or more files or
-# directories that contain example code fragments that are included (see
-# the \include command).
-
-EXAMPLE_PATH           = @top_srcdir@/utils
-
-#---------------------------------------------------------------------------
-# configuration options related to the HTML output
-#---------------------------------------------------------------------------
+@INCLUDE = manual-common.conf
 
 # If the GENERATE_HTML tag is set to YES (the default) Doxygen will
 # generate HTML output.
@@ -52,7 +9,7 @@ GENERATE_HTML          = YES
 # If a relative path is entered the value of OUTPUT_DIRECTORY will be
 # put in front of it. If left blank `html' will be used as the default path.
 
-HTML_OUTPUT            = api
+HTML_OUTPUT            = manual-html
 
 # The HTML_FILE_EXTENSION tag can be used to specify the file extension for
 # each generated HTML page (for example: .htm,.php,.asp). If it is left blank
@@ -79,12 +36,6 @@ HTML_FOOTER            =
 
 HTML_STYLESHEET        =
 
-# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes,
-# files or namespaces will be aligned in HTML using tables. If set to
-# NO a bullet list will be used.
-
-HTML_ALIGN_MEMBERS     = YES
-
 # If the GENERATE_HTMLHELP tag is set to YES, additional index files
 # will be generated that can be used as input for tools like the
 # Microsoft HTML help workshop to generate a compressed HTML help file (.chm)
diff --git a/doc/doxygen/Doxyfile-nucleus.in b/doc/doxygen/manual-pdf.conf.in
similarity index 75%
rename from doc/doxygen/Doxyfile-nucleus.in
rename to doc/doxygen/manual-pdf.conf.in
index 5eef9f3..bf3dc21 100644
--- a/doc/doxygen/Doxyfile-nucleus.in
+++ b/doc/doxygen/manual-pdf.conf.in
@@ -1,138 +1,110 @@
-@INCLUDE = Doxyfile-common
+@INCLUDE = manual-common.conf
 
-# Doxyfile 1.3.4
-
-# The PROJECT_NAME tag is a single word (or a sequence of words surrounded 
-# by quotes) that should identify the project.
-
-PROJECT_NAME           = "Xenomai/cobalt core"
-
-# The INPUT tag can be used to specify the files and/or directories that 
contain 
-# documented source files. You may enter file names like "myfile.cpp" or 
-# directories like "/usr/src/myproject". Separate the files or directories 
-# with spaces.
-
-INPUT                  = \
-        @top_srcdir@/include/cobalt/uapi \
-        @top_srcdir@/include/cobalt/kernel \
-        @top_srcdir@/kernel/cobalt \
-        @top_srcdir@/doc/doxygen
-
-#---------------------------------------------------------------------------
-# configuration options related to the HTML output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_HTML tag is set to YES (the default) Doxygen will 
+# If the GENERATE_HTML tag is set to YES (the default) Doxygen will
 # generate HTML output.
 
 GENERATE_HTML          = NO
 
-# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. 
-# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# The HTML_OUTPUT tag is used to specify where the HTML docs will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
 # put in front of it. If left blank `html' will be used as the default path.
 
-HTML_OUTPUT            = api
+HTML_OUTPUT            =
 
-# The HTML_FILE_EXTENSION tag can be used to specify the file extension for 
-# each generated HTML page (for example: .htm,.php,.asp). If it is left blank 
+# The HTML_FILE_EXTENSION tag can be used to specify the file extension for
+# each generated HTML page (for example: .htm,.php,.asp). If it is left blank
 # doxygen will generate files with .html extension.
 
 HTML_FILE_EXTENSION    = .html
 
-# The HTML_HEADER tag can be used to specify a personal HTML header for 
-# each generated HTML page. If it is left blank doxygen will generate a 
+# The HTML_HEADER tag can be used to specify a personal HTML header for
+# each generated HTML page. If it is left blank doxygen will generate a
 # standard header.
 
-HTML_HEADER            = 
+HTML_HEADER            =
 
-# The HTML_FOOTER tag can be used to specify a personal HTML footer for 
-# each generated HTML page. If it is left blank doxygen will generate a 
+# The HTML_FOOTER tag can be used to specify a personal HTML footer for
+# each generated HTML page. If it is left blank doxygen will generate a
 # standard footer.
 
-HTML_FOOTER            = 
+HTML_FOOTER            =
 
-# The HTML_STYLESHEET tag can be used to specify a user-defined cascading 
-# style sheet that is used by each HTML page. It can be used to 
-# fine-tune the look of the HTML output. If the tag is left blank doxygen 
+# The HTML_STYLESHEET tag can be used to specify a user-defined cascading
+# style sheet that is used by each HTML page. It can be used to
+# fine-tune the look of the HTML output. If the tag is left blank doxygen
 # will generate a default style sheet
 
-HTML_STYLESHEET        = 
-
-# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, 
-# files or namespaces will be aligned in HTML using tables. If set to 
-# NO a bullet list will be used.
-
-HTML_ALIGN_MEMBERS     = YES
+HTML_STYLESHEET        =
 
-# If the GENERATE_HTMLHELP tag is set to YES, additional index files 
-# will be generated that can be used as input for tools like the 
-# Microsoft HTML help workshop to generate a compressed HTML help file (.chm) 
+# If the GENERATE_HTMLHELP tag is set to YES, additional index files
+# will be generated that can be used as input for tools like the
+# Microsoft HTML help workshop to generate a compressed HTML help file (.chm)
 # of the generated HTML documentation.
 
 GENERATE_HTMLHELP      = NO
 
-# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can 
-# be used to specify the file name of the resulting .chm file. You 
-# can add a path in front of the file if the result should not be 
+# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can
+# be used to specify the file name of the resulting .chm file. You
+# can add a path in front of the file if the result should not be
 # written to the html output dir.
 
-CHM_FILE               = 
+CHM_FILE               =
 
-# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can 
-# be used to specify the location (absolute path including file name) of 
-# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run 
+# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can
+# be used to specify the location (absolute path including file name) of
+# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run
 # the HTML help compiler on the generated index.hhp.
 
-HHC_LOCATION           = 
+HHC_LOCATION           =
 
-# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag 
-# controls if a separate .chi index file is generated (YES) or that 
+# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag
+# controls if a separate .chi index file is generated (YES) or that
 # it should be included in the master .chm file (NO).
 
 GENERATE_CHI           = NO
 
-# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag 
-# controls whether a binary table of contents is generated (YES) or a 
+# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag
+# controls whether a binary table of contents is generated (YES) or a
 # normal table of contents (NO) in the .chm file.
 
 BINARY_TOC             = NO
 
-# The TOC_EXPAND flag can be set to YES to add extra items for group members 
+# The TOC_EXPAND flag can be set to YES to add extra items for group members
 # to the contents of the HTML help documentation and to the tree view.
 
 TOC_EXPAND             = NO
 
-# The DISABLE_INDEX tag can be used to turn on/off the condensed index at 
-# top of each HTML page. The value NO (the default) enables the index and 
+# The DISABLE_INDEX tag can be used to turn on/off the condensed index at
+# top of each HTML page. The value NO (the default) enables the index and
 # the value YES disables it.
 
 DISABLE_INDEX          = NO
 
-# This tag can be used to set the number of enum values (range [1..20]) 
+# This tag can be used to set the number of enum values (range [1..20])
 # that doxygen will group on one line in the generated HTML documentation.
 
 ENUM_VALUES_PER_LINE   = 4
 
 # If the GENERATE_TREEVIEW tag is set to YES, a side panel will be
-# generated containing a tree-like index structure (just like the one that 
-# is generated for HTML Help). For this to work a browser that supports 
-# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, 
-# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are 
+# generated containing a tree-like index structure (just like the one that
+# is generated for HTML Help). For this to work a browser that supports
+# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+,
+# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are
 # probably better off using the HTML help feature.
 
 GENERATE_TREEVIEW      = YES
 
-# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be 
-# used to set the initial width (in pixels) of the frame in which the tree 
+# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be
+# used to set the initial width (in pixels) of the frame in which the tree
 # is shown.
 
 TREEVIEW_WIDTH         = 250
 
 #---------------------------------------------------------------------------
-# Configuration::addtions related to the search engine   
+# Configuration::addtions related to the search engine  
 #---------------------------------------------------------------------------
 
-# The SEARCHENGINE tag specifies whether or not a search engine should be 
+# The SEARCHENGINE tag specifies whether or not a search engine should be
 # used. If set to NO the values of all tags below this one will be ignored.
 
 SEARCHENGINE           = NO
@@ -141,84 +113,84 @@ SEARCHENGINE           = NO
 # configuration options related to the LaTeX output
 #---------------------------------------------------------------------------
 
-# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will 
+# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will
 # generate Latex output.
 
 GENERATE_LATEX         = YES
 
-# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. 
-# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be
 # put in front of it. If left blank `latex' will be used as the default path.
 
-LATEX_OUTPUT           = latex-nucleus
+LATEX_OUTPUT           = manual-latex
 
-# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be 
+# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
 # invoked. If left blank `latex' will be used as the default command name.
 
 LATEX_CMD_NAME         = latex
 
-# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to 
-# generate index for LaTeX. If left blank `makeindex' will be used as the 
+# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to
+# generate index for LaTeX. If left blank `makeindex' will be used as the
 # default command name.
 
 MAKEINDEX_CMD_NAME     = makeindex
 
-# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact 
-# LaTeX documents. This may be useful for small projects and may help to 
+# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact
+# LaTeX documents. This may be useful for small projects and may help to
 # save some trees in general.
 
 COMPACT_LATEX          = NO
 
-# The PAPER_TYPE tag can be used to set the paper type that is used 
-# by the printer. Possible values are: a4, a4wide, letter, legal and 
+# The PAPER_TYPE tag can be used to set the paper type that is used
+# by the printer. Possible values are: a4, a4wide, letter, legal and
 # executive. If left blank a4wide will be used.
 
 PAPER_TYPE             = a4wide
 
-# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX 
+# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX
 # packages that should be included in the LaTeX output.
 
 EXTRA_PACKAGES         = pxfonts
 
-# The LATEX_HEADER tag can be used to specify a personal LaTeX header for 
-# the generated latex document. The header should contain everything until 
-# the first chapter. If it is left blank doxygen will generate a 
+# The LATEX_HEADER tag can be used to specify a personal LaTeX header for
+# the generated latex document. The header should contain everything until
+# the first chapter. If it is left blank doxygen will generate a
 # standard header. Notice: only use this tag if you know what you are doing!
 
-LATEX_HEADER           = 
+LATEX_HEADER           =
 
-# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated 
-# is prepared for conversion to pdf (using ps2pdf). The pdf file will 
-# contain links (just like the HTML output) instead of page references 
+# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated
+# is prepared for conversion to pdf (using ps2pdf). The pdf file will
+# contain links (just like the HTML output) instead of page references
 # This makes the output suitable for online browsing using a pdf viewer.
 
 PDF_HYPERLINKS         = YES
 
-# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of 
-# plain latex in the generated Makefile. Set this option to YES to get a 
+# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of
+# plain latex in the generated Makefile. Set this option to YES to get a
 # higher quality PDF documentation.
 
 USE_PDFLATEX           = YES
 
-# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. 
-# command to the generated LaTeX files. This will instruct LaTeX to keep 
-# running if errors occur, instead of asking the user for help. 
+# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode.
+# command to the generated LaTeX files. This will instruct LaTeX to keep
+# running if errors occur, instead of asking the user for help.
 # This option is also used when generating formulas in HTML.
 
 LATEX_BATCHMODE        = @LATEX_BATCHMODE@
 
-# If LATEX_HIDE_INDICES is set to YES then doxygen will not 
-# include the index chapters (such as File Index, Compound Index, etc.) 
+# If LATEX_HIDE_INDICES is set to YES then doxygen will not
+# include the index chapters (such as File Index, Compound Index, etc.)
 # in the output.
 
 LATEX_HIDE_INDICES     = NO
 
 #---------------------------------------------------------------------------
-# Configuration options related to the preprocessor   
+# Configuration options related to the preprocessor  
 #---------------------------------------------------------------------------
 
-# The INCLUDE_PATH tag can be used to specify one or more directories that 
-# contain include files that are not input files but should be processed by 
+# The INCLUDE_PATH tag can be used to specify one or more directories that
+# contain include files that are not input files but should be processed by
 # the preprocessor.
 
 INCLUDE_PATH           =


_______________________________________________
Xenomai-git mailing list
Xenomai-git@xenomai.org
http://www.xenomai.org/mailman/listinfo/xenomai-git

Reply via email to