added building of html source code documentation with Doxygen
git-svn-id: https://zeitsenke.de/svn/SyncEvolution/trunk@687 15ad00c4-1369-45f4-8270-35d70d36bdcd
This commit is contained in:
parent
d1666c5acc
commit
9a9a75dbc2
3 changed files with 24 additions and 11 deletions
22
Doxyfile
22
Doxyfile
|
@ -25,20 +25,20 @@ DOXYFILE_ENCODING = UTF-8
|
|||
# The PROJECT_NAME tag is a single word (or a sequence of words surrounded
|
||||
# by quotes) that should identify the project.
|
||||
|
||||
PROJECT_NAME =
|
||||
PROJECT_NAME = SyncEvolution
|
||||
|
||||
# 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.
|
||||
|
||||
PROJECT_NUMBER =
|
||||
PROJECT_NUMBER = $(VERSION)
|
||||
|
||||
# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
|
||||
# base path where the generated documentation will be put.
|
||||
# If a relative path is entered, it will be relative to the location
|
||||
# where doxygen was started. If left blank the current directory will be used.
|
||||
|
||||
OUTPUT_DIRECTORY =
|
||||
OUTPUT_DIRECTORY = $(OUTPUT_DIRECTORY)
|
||||
|
||||
# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create
|
||||
# 4096 sub-directories (in 2 levels) under the output directory of each output
|
||||
|
@ -239,7 +239,7 @@ SUBGROUPING = YES
|
|||
# Private class members and static file members will be hidden unless
|
||||
# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES
|
||||
|
||||
EXTRACT_ALL = NO
|
||||
EXTRACT_ALL = YES
|
||||
|
||||
# If the EXTRACT_PRIVATE tag is set to YES all private members of a class
|
||||
# will be included in the documentation.
|
||||
|
@ -436,7 +436,7 @@ WARNINGS = YES
|
|||
# for undocumented members. If EXTRACT_ALL is set to YES then this flag will
|
||||
# automatically be disabled.
|
||||
|
||||
WARN_IF_UNDOCUMENTED = YES
|
||||
WARN_IF_UNDOCUMENTED = NO
|
||||
|
||||
# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for
|
||||
# potential errors in the documentation, such as not documenting some
|
||||
|
@ -477,7 +477,7 @@ WARN_LOGFILE =
|
|||
# directories like "/usr/src/myproject". Separate the files or directories
|
||||
# with spaces.
|
||||
|
||||
INPUT =
|
||||
INPUT = src test
|
||||
|
||||
# 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 also the default
|
||||
|
@ -499,7 +499,7 @@ FILE_PATTERNS =
|
|||
# should be searched for input files as well. Possible values are YES and NO.
|
||||
# If left blank NO is used.
|
||||
|
||||
RECURSIVE = NO
|
||||
RECURSIVE = YES
|
||||
|
||||
# The EXCLUDE tag can be used to specify files and/or directories that should
|
||||
# excluded from the INPUT source files. This way you can easily exclude a
|
||||
|
@ -519,7 +519,7 @@ EXCLUDE_SYMLINKS = NO
|
|||
# against the file with absolute path, so to exclude all test directories
|
||||
# for example use the pattern */test/*
|
||||
|
||||
EXCLUDE_PATTERNS =
|
||||
EXCLUDE_PATTERNS = **/.svn */src/client-api/* */src/core/vocl */src/client-api.build/* */src/boost/*
|
||||
|
||||
# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
|
||||
# (namespaces, classes, functions, etc.) that should be excluded from the output.
|
||||
|
@ -786,7 +786,7 @@ TREEVIEW_WIDTH = 250
|
|||
# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will
|
||||
# generate Latex output.
|
||||
|
||||
GENERATE_LATEX = YES
|
||||
GENERATE_LATEX = no
|
||||
|
||||
# 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
|
||||
|
@ -1054,7 +1054,7 @@ INCLUDE_FILE_PATTERNS =
|
|||
# undefined via #undef or recursively expanded use the := operator
|
||||
# instead of the = operator.
|
||||
|
||||
PREDEFINED =
|
||||
PREDEFINED = $(PREDEFINED)
|
||||
|
||||
# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then
|
||||
# this tag can be used to specify a list of macro names that should be expanded.
|
||||
|
@ -1146,7 +1146,7 @@ HIDE_UNDOC_RELATIONS = YES
|
|||
# toolkit from AT&T and Lucent Bell Labs. The other options in this section
|
||||
# have no effect if this option is set to NO (the default)
|
||||
|
||||
HAVE_DOT = NO
|
||||
HAVE_DOT = YES
|
||||
|
||||
# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen
|
||||
# will generate a graph for each documented class showing the direct and
|
||||
|
|
|
@ -80,6 +80,17 @@ doc-pak : README NEWS COPYING
|
|||
description-pak : description
|
||||
cp $< $@
|
||||
|
||||
.PHONY: doc clean-html
|
||||
doc:
|
||||
rm -rf html
|
||||
export VERSION=$(VERSION); \
|
||||
export OUTPUT_DIRECTORY="`pwd`"; \
|
||||
export PREDEFINED="@BACKEND_DEFINES@"; \
|
||||
cd $(srcdir); doxygen
|
||||
clean-local: clean-html
|
||||
clean-html:
|
||||
rm -rf html
|
||||
|
||||
# Because backend-related variables need to be substituted in
|
||||
# Makefile-gen.am and configure.in we need an explicit rule to redo that work
|
||||
# so that "make" rebuilds derived files correctly.
|
||||
|
|
|
@ -207,10 +207,12 @@ AC_DEFUN([AC_ARG_ENABLE_BACKEND],
|
|||
[
|
||||
AC_ARG_ENABLE($1, $3, $4, $5)
|
||||
BACKENDS="$BACKENDS $1"
|
||||
BACKEND_DEFINES="$BACKEND_DEFINES ENABLE_`echo $1 | tr a-z A-Z`"
|
||||
for source in $2; do
|
||||
SYNCSOURCES="$SYNCSOURCES backends/$2/sync$1.la"
|
||||
done
|
||||
])
|
||||
AC_SUBST(SYNCSOURCES)
|
||||
AC_SUBST(BACKEND_DEFINES)
|
||||
|
||||
dnl src/backends/*/configure-sub.in and configure-post.in follow
|
||||
|
|
Loading…
Reference in a new issue