Message ID | 1510135312-16578-1-git-send-email-steffan.karger@fox-it.com |
---|---|
State | Superseded |
Headers | show |
Series | [Openvpn-devel,v2] doxygen: add make target and use relative paths | expand |
2017-11-08 15:01 GMT+05:00 Steffan Karger <steffan.karger@fox-it.com>: > Add a make target, such that 'make doxygen' works (both for in-tree and > out-of-tree builds). > should we add both variants of 'make doxygen' to travis-ci matrix ? > > While doing so, instead of genering docs with full path names (e.g. > /home/steffan/dev/openvpn/src/openvpn/crypto.h), use a relative path wrt > the project root (e.g. src/openvpn/crypto.h) in the generated > documentation. This makes the generated doxygen easier to read. > > Signed-off-by: Steffan Karger <steffan.karger@fox-it.com> > --- > v2: > - merge patches 1/2 and 2/2 from the v1 set > - use abs_top_srcdir (instead of top_srcdir) > > Makefile.am | 5 +- > configure.ac | 1 + > doc/Makefile.am | 2 + > doc/doxygen/openvpn.doxyfile | 279 ------------------------------ > ---------- > doc/doxygen/openvpn.doxyfile.in | 279 ++++++++++++++++++++++++++++++ > ++++++++++ > 5 files changed, 286 insertions(+), 280 deletions(-) > delete mode 100644 doc/doxygen/openvpn.doxyfile > create mode 100644 doc/doxygen/openvpn.doxyfile.in > > diff --git a/Makefile.am b/Makefile.am > index 87af724..34632c4 100644 > --- a/Makefile.am > +++ b/Makefile.am > @@ -46,7 +46,7 @@ EXTRA_DIST = \ > contrib \ > debug > > -.PHONY: config-version.h > +.PHONY: config-version.h doxygen > > if GIT_CHECKOUT > BUILT_SOURCES = \ > @@ -96,3 +96,6 @@ config-version.h: > else \ > rm -f config-version.h.tmp; \ > fi > + > +doxygen: doc/doxygen/openvpn.doxyfile > + doxygen doc/doxygen/openvpn.doxyfile > diff --git a/configure.ac b/configure.ac > index 45aa501..eca83e6 100644 > --- a/configure.ac > +++ b/configure.ac > @@ -1420,6 +1420,7 @@ AC_CONFIG_FILES([ > distro/rpm/Makefile > distro/rpm/openvpn.spec > distro/systemd/Makefile > + doc/doxygen/openvpn.doxyfile > include/Makefile > src/Makefile > src/compat/Makefile > diff --git a/doc/Makefile.am b/doc/Makefile.am > index dedd1fa..f9e7f4a 100644 > --- a/doc/Makefile.am > +++ b/doc/Makefile.am > @@ -14,6 +14,8 @@ MAINTAINERCLEANFILES = \ > > CLEANFILES = openvpn.8.html > > +SUBDIRS = doxygen > + > dist_doc_DATA = \ > management-notes.txt > > diff --git a/doc/doxygen/openvpn.doxyfile b/doc/doxygen/openvpn.doxyfile > deleted file mode 100644 > index a7d9728..0000000 > --- a/doc/doxygen/openvpn.doxyfile > +++ /dev/null > @@ -1,279 +0,0 @@ > -# Doxyfile 1.5.5 > - > -#---------------------------------------------------------- > ----------------- > -# Project related configuration options > -#---------------------------------------------------------- > ----------------- > -DOXYFILE_ENCODING = UTF-8 > -PROJECT_NAME = "OpenVPN" > -PROJECT_NUMBER = > -OUTPUT_DIRECTORY = doxygen > -CREATE_SUBDIRS = NO > -OUTPUT_LANGUAGE = English > -BRIEF_MEMBER_DESC = YES > -REPEAT_BRIEF = YES > -ABBREVIATE_BRIEF = "The $name class" \ > - "The $name widget" \ > - "The $name file" \ > - is \ > - provides \ > - specifies \ > - contains \ > - represents \ > - a \ > - an \ > - the > -ALWAYS_DETAILED_SEC = NO > -INLINE_INHERITED_MEMB = NO > -FULL_PATH_NAMES = YES > -STRIP_FROM_PATH = "" > -STRIP_FROM_INC_PATH = > -SHORT_NAMES = NO > -JAVADOC_AUTOBRIEF = YES # NO > -QT_AUTOBRIEF = NO > -MULTILINE_CPP_IS_BRIEF = NO > -DETAILS_AT_TOP = NO > -INHERIT_DOCS = YES > -SEPARATE_MEMBER_PAGES = NO > -TAB_SIZE = 8 > -ALIASES = > -OPTIMIZE_OUTPUT_FOR_C = YES > -OPTIMIZE_OUTPUT_JAVA = NO > -OPTIMIZE_FOR_FORTRAN = NO > -OPTIMIZE_OUTPUT_VHDL = NO > -BUILTIN_STL_SUPPORT = NO > -CPP_CLI_SUPPORT = NO > -SIP_SUPPORT = NO > -DISTRIBUTE_GROUP_DOC = NO > -SUBGROUPING = YES > -TYPEDEF_HIDES_STRUCT = NO > -#---------------------------------------------------------- > ----------------- > -# Build related configuration options > -#---------------------------------------------------------- > ----------------- > -EXTRACT_ALL = YES > -EXTRACT_PRIVATE = YES > -EXTRACT_STATIC = YES > -EXTRACT_LOCAL_CLASSES = YES > -EXTRACT_LOCAL_METHODS = YES > -EXTRACT_ANON_NSPACES = YES > -HIDE_UNDOC_MEMBERS = NO > -HIDE_UNDOC_CLASSES = NO > -HIDE_FRIEND_COMPOUNDS = NO > -HIDE_IN_BODY_DOCS = NO > -INTERNAL_DOCS = NO > -CASE_SENSE_NAMES = NO > -HIDE_SCOPE_NAMES = NO > -SHOW_INCLUDE_FILES = YES > -INLINE_INFO = YES > -SORT_MEMBER_DOCS = YES > -SORT_BRIEF_DOCS = NO > -SORT_GROUP_NAMES = NO > -SORT_BY_SCOPE_NAME = NO > -GENERATE_TODOLIST = YES > -GENERATE_TESTLIST = YES > -GENERATE_BUGLIST = YES > -GENERATE_DEPRECATEDLIST= YES > -ENABLED_SECTIONS = > -MAX_INITIALIZER_LINES = 30 > -SHOW_USED_FILES = YES > -SHOW_DIRECTORIES = NO > -FILE_VERSION_FILTER = > -#---------------------------------------------------------- > ----------------- > -# configuration options related to warning and progress messages > -#---------------------------------------------------------- > ----------------- > -QUIET = NO > -WARNINGS = YES > -WARN_IF_UNDOCUMENTED = YES > -WARN_IF_DOC_ERROR = YES > -WARN_NO_PARAMDOC = NO > -WARN_FORMAT = "$file:$line: $text" > -WARN_LOGFILE = > -#---------------------------------------------------------- > ----------------- > -# configuration options related to the input files > -#---------------------------------------------------------- > ----------------- > -INPUT = . > -INPUT_ENCODING = UTF-8 > -FILE_PATTERNS = *.c \ > - *.cc \ > - *.cxx \ > - *.cpp \ > - *.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 > -RECURSIVE = YES > -EXCLUDE = > -EXCLUDE_SYMLINKS = NO > -EXCLUDE_PATTERNS = > -EXCLUDE_SYMBOLS = > -EXAMPLE_PATH = > -EXAMPLE_PATTERNS = * > -EXAMPLE_RECURSIVE = NO > -IMAGE_PATH = > -INPUT_FILTER = > -FILTER_PATTERNS = > -FILTER_SOURCE_FILES = NO > -#---------------------------------------------------------- > ----------------- > -# configuration options related to source browsing > -#---------------------------------------------------------- > ----------------- > -SOURCE_BROWSER = YES > -INLINE_SOURCES = NO > -STRIP_CODE_COMMENTS = YES > -REFERENCED_BY_RELATION = YES > -REFERENCES_RELATION = YES > -REFERENCES_LINK_SOURCE = YES > -USE_HTAGS = NO > -VERBATIM_HEADERS = YES > -#---------------------------------------------------------- > ----------------- > -# configuration options related to the alphabetical class index > -#---------------------------------------------------------- > ----------------- > -ALPHABETICAL_INDEX = NO > -COLS_IN_ALPHA_INDEX = 5 > -IGNORE_PREFIX = > -#---------------------------------------------------------- > ----------------- > -# configuration options related to the HTML output > -#---------------------------------------------------------- > ----------------- > -GENERATE_HTML = YES > -HTML_OUTPUT = html > -HTML_FILE_EXTENSION = .html > -HTML_HEADER = > -HTML_FOOTER = > -HTML_STYLESHEET = > -HTML_ALIGN_MEMBERS = YES > -GENERATE_HTMLHELP = NO > -GENERATE_DOCSET = NO > -DOCSET_FEEDNAME = "Doxygen generated docs" > -DOCSET_BUNDLE_ID = org.doxygen.Project > -HTML_DYNAMIC_SECTIONS = NO > -CHM_FILE = > -HHC_LOCATION = > -GENERATE_CHI = NO > -BINARY_TOC = NO > -TOC_EXPAND = NO > -DISABLE_INDEX = NO > -ENUM_VALUES_PER_LINE = 4 > -GENERATE_TREEVIEW = NO > -TREEVIEW_WIDTH = 250 > -#---------------------------------------------------------- > ----------------- > -# configuration options related to the LaTeX output > -#---------------------------------------------------------- > ----------------- > -GENERATE_LATEX = YES > -LATEX_OUTPUT = latex > -LATEX_CMD_NAME = latex > -MAKEINDEX_CMD_NAME = makeindex > -COMPACT_LATEX = YES # NO > -PAPER_TYPE = a4wide > -EXTRA_PACKAGES = > -LATEX_HEADER = > -PDF_HYPERLINKS = YES > -USE_PDFLATEX = YES > -LATEX_BATCHMODE = NO > -LATEX_HIDE_INDICES = NO > -#---------------------------------------------------------- > ----------------- > -# configuration options related to the RTF output > -#---------------------------------------------------------- > ----------------- > -GENERATE_RTF = NO > -RTF_OUTPUT = rtf > -COMPACT_RTF = NO > -RTF_HYPERLINKS = NO > -RTF_STYLESHEET_FILE = > -RTF_EXTENSIONS_FILE = > -#---------------------------------------------------------- > ----------------- > -# configuration options related to the man page output > -#---------------------------------------------------------- > ----------------- > -GENERATE_MAN = NO > -MAN_OUTPUT = man > -MAN_EXTENSION = .3 > -MAN_LINKS = NO > -#---------------------------------------------------------- > ----------------- > -# configuration options related to the XML output > -#---------------------------------------------------------- > ----------------- > -GENERATE_XML = NO > -XML_OUTPUT = xml > -XML_SCHEMA = > -XML_DTD = > -XML_PROGRAMLISTING = YES > -#---------------------------------------------------------- > ----------------- > -# configuration options for the AutoGen Definitions output > -#---------------------------------------------------------- > ----------------- > -GENERATE_AUTOGEN_DEF = NO > -#---------------------------------------------------------- > ----------------- > -# configuration options related to the Perl module output > -#---------------------------------------------------------- > ----------------- > -GENERATE_PERLMOD = NO > -PERLMOD_LATEX = NO > -PERLMOD_PRETTY = YES > -PERLMOD_MAKEVAR_PREFIX = > -#---------------------------------------------------------- > ----------------- > -# Configuration options related to the preprocessor > -#---------------------------------------------------------- > ----------------- > -ENABLE_PREPROCESSING = YES > -MACRO_EXPANSION = NO > -EXPAND_ONLY_PREDEF = NO > -SEARCH_INCLUDES = YES > -INCLUDE_PATH = > -INCLUDE_FILE_PATTERNS = > -PREDEFINED = _WIN32 NTLM USE_LZO ENABLE_FRAGMENT P2MP > P2MP_SERVER ENABLE_CRYPTO ENABLE_CRYPTO_OPENSSL ENABLE_PLUGIN > ENABLE_MANAGEMENT ENABLE_OCC HAVE_GETTIMEOFDAY > -EXPAND_AS_DEFINED = > -SKIP_FUNCTION_MACROS = YES > -#---------------------------------------------------------- > ----------------- > -# Configuration::additions related to external references > -#---------------------------------------------------------- > ----------------- > -TAGFILES = > -GENERATE_TAGFILE = > -ALLEXTERNALS = NO > -EXTERNAL_GROUPS = YES > -PERL_PATH = /usr/bin/perl > -#---------------------------------------------------------- > ----------------- > -# Configuration options related to the dot tool > -#---------------------------------------------------------- > ----------------- > -CLASS_DIAGRAMS = NO > -MSCGEN_PATH = > -HIDE_UNDOC_RELATIONS = YES > -HAVE_DOT = YES > -CLASS_GRAPH = YES > -COLLABORATION_GRAPH = YES > -GROUP_GRAPHS = YES > -UML_LOOK = NO > -TEMPLATE_RELATIONS = NO > -INCLUDE_GRAPH = YES > -INCLUDED_BY_GRAPH = YES > -CALL_GRAPH = NO # YES > -CALLER_GRAPH = NO # YES > -GRAPHICAL_HIERARCHY = YES > -DIRECTORY_GRAPH = YES > -DOT_IMAGE_FORMAT = png > -DOT_PATH = "/usr/bin/dot" > -DOTFILE_DIRS = > -DOT_GRAPH_MAX_NODES = 50 > -MAX_DOT_GRAPH_DEPTH = 1000 > -DOT_TRANSPARENT = YES > -DOT_MULTI_TARGETS = NO > -GENERATE_LEGEND = YES > -DOT_CLEANUP = YES > -#---------------------------------------------------------- > ----------------- > -# Configuration::additions related to the search engine > -#---------------------------------------------------------- > ----------------- > -SEARCHENGINE = NO > diff --git a/doc/doxygen/openvpn.doxyfile.in b/doc/doxygen/openvpn. > doxyfile.in > new file mode 100644 > index 0000000..e1cdc3b > --- /dev/null > +++ b/doc/doxygen/openvpn.doxyfile.in > @@ -0,0 +1,279 @@ > +# Doxyfile 1.5.5 > + > +#---------------------------------------------------------- > ----------------- > +# Project related configuration options > +#---------------------------------------------------------- > ----------------- > +DOXYFILE_ENCODING = UTF-8 > +PROJECT_NAME = "OpenVPN" > +PROJECT_NUMBER = > +OUTPUT_DIRECTORY = doxygen > +CREATE_SUBDIRS = NO > +OUTPUT_LANGUAGE = English > +BRIEF_MEMBER_DESC = YES > +REPEAT_BRIEF = YES > +ABBREVIATE_BRIEF = "The $name class" \ > + "The $name widget" \ > + "The $name file" \ > + is \ > + provides \ > + specifies \ > + contains \ > + represents \ > + a \ > + an \ > + the > +ALWAYS_DETAILED_SEC = NO > +INLINE_INHERITED_MEMB = NO > +FULL_PATH_NAMES = YES > +STRIP_FROM_PATH = @abs_top_srcdir@ > +STRIP_FROM_INC_PATH = > +SHORT_NAMES = NO > +JAVADOC_AUTOBRIEF = YES # NO > +QT_AUTOBRIEF = NO > +MULTILINE_CPP_IS_BRIEF = NO > +DETAILS_AT_TOP = NO > +INHERIT_DOCS = YES > +SEPARATE_MEMBER_PAGES = NO > +TAB_SIZE = 8 > +ALIASES = > +OPTIMIZE_OUTPUT_FOR_C = YES > +OPTIMIZE_OUTPUT_JAVA = NO > +OPTIMIZE_FOR_FORTRAN = NO > +OPTIMIZE_OUTPUT_VHDL = NO > +BUILTIN_STL_SUPPORT = NO > +CPP_CLI_SUPPORT = NO > +SIP_SUPPORT = NO > +DISTRIBUTE_GROUP_DOC = NO > +SUBGROUPING = YES > +TYPEDEF_HIDES_STRUCT = NO > +#---------------------------------------------------------- > ----------------- > +# Build related configuration options > +#---------------------------------------------------------- > ----------------- > +EXTRACT_ALL = YES > +EXTRACT_PRIVATE = YES > +EXTRACT_STATIC = YES > +EXTRACT_LOCAL_CLASSES = YES > +EXTRACT_LOCAL_METHODS = YES > +EXTRACT_ANON_NSPACES = YES > +HIDE_UNDOC_MEMBERS = NO > +HIDE_UNDOC_CLASSES = NO > +HIDE_FRIEND_COMPOUNDS = NO > +HIDE_IN_BODY_DOCS = NO > +INTERNAL_DOCS = NO > +CASE_SENSE_NAMES = NO > +HIDE_SCOPE_NAMES = NO > +SHOW_INCLUDE_FILES = YES > +INLINE_INFO = YES > +SORT_MEMBER_DOCS = YES > +SORT_BRIEF_DOCS = NO > +SORT_GROUP_NAMES = NO > +SORT_BY_SCOPE_NAME = NO > +GENERATE_TODOLIST = YES > +GENERATE_TESTLIST = YES > +GENERATE_BUGLIST = YES > +GENERATE_DEPRECATEDLIST= YES > +ENABLED_SECTIONS = > +MAX_INITIALIZER_LINES = 30 > +SHOW_USED_FILES = YES > +SHOW_DIRECTORIES = NO > +FILE_VERSION_FILTER = > +#---------------------------------------------------------- > ----------------- > +# configuration options related to warning and progress messages > +#---------------------------------------------------------- > ----------------- > +QUIET = NO > +WARNINGS = YES > +WARN_IF_UNDOCUMENTED = YES > +WARN_IF_DOC_ERROR = YES > +WARN_NO_PARAMDOC = NO > +WARN_FORMAT = "$file:$line: $text" > +WARN_LOGFILE = > +#---------------------------------------------------------- > ----------------- > +# configuration options related to the input files > +#---------------------------------------------------------- > ----------------- > +INPUT = @abs_top_srcdir@ > +INPUT_ENCODING = UTF-8 > +FILE_PATTERNS = *.c \ > + *.cc \ > + *.cxx \ > + *.cpp \ > + *.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 > +RECURSIVE = YES > +EXCLUDE = > +EXCLUDE_SYMLINKS = NO > +EXCLUDE_PATTERNS = > +EXCLUDE_SYMBOLS = > +EXAMPLE_PATH = > +EXAMPLE_PATTERNS = * > +EXAMPLE_RECURSIVE = NO > +IMAGE_PATH = > +INPUT_FILTER = > +FILTER_PATTERNS = > +FILTER_SOURCE_FILES = NO > +#---------------------------------------------------------- > ----------------- > +# configuration options related to source browsing > +#---------------------------------------------------------- > ----------------- > +SOURCE_BROWSER = YES > +INLINE_SOURCES = NO > +STRIP_CODE_COMMENTS = YES > +REFERENCED_BY_RELATION = YES > +REFERENCES_RELATION = YES > +REFERENCES_LINK_SOURCE = YES > +USE_HTAGS = NO > +VERBATIM_HEADERS = YES > +#---------------------------------------------------------- > ----------------- > +# configuration options related to the alphabetical class index > +#---------------------------------------------------------- > ----------------- > +ALPHABETICAL_INDEX = NO > +COLS_IN_ALPHA_INDEX = 5 > +IGNORE_PREFIX = > +#---------------------------------------------------------- > ----------------- > +# configuration options related to the HTML output > +#---------------------------------------------------------- > ----------------- > +GENERATE_HTML = YES > +HTML_OUTPUT = html > +HTML_FILE_EXTENSION = .html > +HTML_HEADER = > +HTML_FOOTER = > +HTML_STYLESHEET = > +HTML_ALIGN_MEMBERS = YES > +GENERATE_HTMLHELP = NO > +GENERATE_DOCSET = NO > +DOCSET_FEEDNAME = "Doxygen generated docs" > +DOCSET_BUNDLE_ID = org.doxygen.Project > +HTML_DYNAMIC_SECTIONS = NO > +CHM_FILE = > +HHC_LOCATION = > +GENERATE_CHI = NO > +BINARY_TOC = NO > +TOC_EXPAND = NO > +DISABLE_INDEX = NO > +ENUM_VALUES_PER_LINE = 4 > +GENERATE_TREEVIEW = NO > +TREEVIEW_WIDTH = 250 > +#---------------------------------------------------------- > ----------------- > +# configuration options related to the LaTeX output > +#---------------------------------------------------------- > ----------------- > +GENERATE_LATEX = YES > +LATEX_OUTPUT = latex > +LATEX_CMD_NAME = latex > +MAKEINDEX_CMD_NAME = makeindex > +COMPACT_LATEX = YES # NO > +PAPER_TYPE = a4wide > +EXTRA_PACKAGES = > +LATEX_HEADER = > +PDF_HYPERLINKS = YES > +USE_PDFLATEX = YES > +LATEX_BATCHMODE = NO > +LATEX_HIDE_INDICES = NO > +#---------------------------------------------------------- > ----------------- > +# configuration options related to the RTF output > +#---------------------------------------------------------- > ----------------- > +GENERATE_RTF = NO > +RTF_OUTPUT = rtf > +COMPACT_RTF = NO > +RTF_HYPERLINKS = NO > +RTF_STYLESHEET_FILE = > +RTF_EXTENSIONS_FILE = > +#---------------------------------------------------------- > ----------------- > +# configuration options related to the man page output > +#---------------------------------------------------------- > ----------------- > +GENERATE_MAN = NO > +MAN_OUTPUT = man > +MAN_EXTENSION = .3 > +MAN_LINKS = NO > +#---------------------------------------------------------- > ----------------- > +# configuration options related to the XML output > +#---------------------------------------------------------- > ----------------- > +GENERATE_XML = NO > +XML_OUTPUT = xml > +XML_SCHEMA = > +XML_DTD = > +XML_PROGRAMLISTING = YES > +#---------------------------------------------------------- > ----------------- > +# configuration options for the AutoGen Definitions output > +#---------------------------------------------------------- > ----------------- > +GENERATE_AUTOGEN_DEF = NO > +#---------------------------------------------------------- > ----------------- > +# configuration options related to the Perl module output > +#---------------------------------------------------------- > ----------------- > +GENERATE_PERLMOD = NO > +PERLMOD_LATEX = NO > +PERLMOD_PRETTY = YES > +PERLMOD_MAKEVAR_PREFIX = > +#---------------------------------------------------------- > ----------------- > +# Configuration options related to the preprocessor > +#---------------------------------------------------------- > ----------------- > +ENABLE_PREPROCESSING = YES > +MACRO_EXPANSION = NO > +EXPAND_ONLY_PREDEF = NO > +SEARCH_INCLUDES = YES > +INCLUDE_PATH = > +INCLUDE_FILE_PATTERNS = > +PREDEFINED = _WIN32 NTLM USE_LZO ENABLE_FRAGMENT P2MP > P2MP_SERVER ENABLE_CRYPTO ENABLE_CRYPTO_OPENSSL ENABLE_PLUGIN > ENABLE_MANAGEMENT ENABLE_OCC HAVE_GETTIMEOFDAY > +EXPAND_AS_DEFINED = > +SKIP_FUNCTION_MACROS = YES > +#---------------------------------------------------------- > ----------------- > +# Configuration::additions related to external references > +#---------------------------------------------------------- > ----------------- > +TAGFILES = > +GENERATE_TAGFILE = > +ALLEXTERNALS = NO > +EXTERNAL_GROUPS = YES > +PERL_PATH = /usr/bin/perl > +#---------------------------------------------------------- > ----------------- > +# Configuration options related to the dot tool > +#---------------------------------------------------------- > ----------------- > +CLASS_DIAGRAMS = NO > +MSCGEN_PATH = > +HIDE_UNDOC_RELATIONS = YES > +HAVE_DOT = YES > +CLASS_GRAPH = YES > +COLLABORATION_GRAPH = YES > +GROUP_GRAPHS = YES > +UML_LOOK = NO > +TEMPLATE_RELATIONS = NO > +INCLUDE_GRAPH = YES > +INCLUDED_BY_GRAPH = YES > +CALL_GRAPH = NO # YES > +CALLER_GRAPH = NO # YES > +GRAPHICAL_HIERARCHY = YES > +DIRECTORY_GRAPH = YES > +DOT_IMAGE_FORMAT = png > +DOT_PATH = "/usr/bin/dot" > +DOTFILE_DIRS = > +DOT_GRAPH_MAX_NODES = 50 > +MAX_DOT_GRAPH_DEPTH = 1000 > +DOT_TRANSPARENT = YES > +DOT_MULTI_TARGETS = NO > +GENERATE_LEGEND = YES > +DOT_CLEANUP = YES > +#---------------------------------------------------------- > ----------------- > +# Configuration::additions related to the search engine > +#---------------------------------------------------------- > ----------------- > +SEARCHENGINE = NO > -- > 2.7.4 > > > ------------------------------------------------------------ > ------------------ > Check out the vibrant tech community on one of the world's most > engaging tech sites, Slashdot.org! http://sdm.link/slashdot > _______________________________________________ > Openvpn-devel mailing list > Openvpn-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/openvpn-devel > <div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">2017-11-08 15:01 GMT+05:00 Steffan Karger <span dir="ltr"><<a href="mailto:steffan.karger@fox-it.com" target="_blank">steffan.karger@fox-it.com</a>></span>:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Add a make target, such that 'make doxygen' works (both for in-tree and<br> out-of-tree builds).<br></blockquote><div><br><br></div><div>should we add both variants of 'make doxygen' to travis-ci matrix ?<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"> <br> While doing so, instead of genering docs with full path names (e.g.<br> /home/steffan/dev/openvpn/src/<wbr>openvpn/crypto.h), use a relative path wrt<br> the project root (e.g. src/openvpn/crypto.h) in the generated<br> documentation. This makes the generated doxygen easier to read.<br> <br> Signed-off-by: Steffan Karger <<a href="mailto:steffan.karger@fox-it.com">steffan.karger@fox-it.com</a>><br> ---<br> v2:<br> - merge patches 1/2 and 2/2 from the v1 set<br> - use abs_top_srcdir (instead of top_srcdir)<br> <br> Makefile.am | 5 +-<br> <a href="http://configure.ac" rel="noreferrer" target="_blank">configure.ac</a> | 1 +<br> doc/Makefile.am | 2 +<br> doc/doxygen/openvpn.doxyfile | 279 ------------------------------<wbr>----------<br> doc/doxygen/<a href="http://openvpn.doxyfile.in" rel="noreferrer" target="_blank">openvpn.doxyfile.<wbr>in</a> | 279 ++++++++++++++++++++++++++++++<wbr>++++++++++<br> 5 files changed, 286 insertions(+), 280 deletions(-)<br> delete mode 100644 doc/doxygen/openvpn.doxyfile<br> create mode 100644 doc/doxygen/<a href="http://openvpn.doxyfile.in" rel="noreferrer" target="_blank">openvpn.doxyfile.<wbr>in</a><br> <br> diff --git a/Makefile.am b/Makefile.am<br> index 87af724..34632c4 100644<br> --- a/Makefile.am<br> +++ b/Makefile.am<br> @@ -46,7 +46,7 @@ EXTRA_DIST = \<br> contrib \<br> debug<br> <br> -.PHONY: config-version.h<br> +.PHONY: config-version.h doxygen<br> <br> if GIT_CHECKOUT<br> BUILT_SOURCES = \<br> @@ -96,3 +96,6 @@ config-version.h:<br> else \<br> rm -f config-version.h.tmp; \<br> fi<br> +<br> +doxygen: doc/doxygen/openvpn.doxyfile<br> + doxygen doc/doxygen/openvpn.doxyfile<br> diff --git a/<a href="http://configure.ac" rel="noreferrer" target="_blank">configure.ac</a> b/<a href="http://configure.ac" rel="noreferrer" target="_blank">configure.ac</a><br> index 45aa501..eca83e6 100644<br> --- a/<a href="http://configure.ac" rel="noreferrer" target="_blank">configure.ac</a><br> +++ b/<a href="http://configure.ac" rel="noreferrer" target="_blank">configure.ac</a><br> @@ -1420,6 +1420,7 @@ AC_CONFIG_FILES([<br> distro/rpm/Makefile<br> distro/rpm/openvpn.spec<br> distro/systemd/Makefile<br> + doc/doxygen/openvpn.doxyfile<br> include/Makefile<br> src/Makefile<br> src/compat/Makefile<br> diff --git a/doc/Makefile.am b/doc/Makefile.am<br> index dedd1fa..f9e7f4a 100644<br> --- a/doc/Makefile.am<br> +++ b/doc/Makefile.am<br> @@ -14,6 +14,8 @@ MAINTAINERCLEANFILES = \<br> <br> CLEANFILES = openvpn.8.html<br> <br> +SUBDIRS = doxygen<br> +<br> dist_doc_DATA = \<br> management-notes.txt<br> <br> diff --git a/doc/doxygen/openvpn.doxyfile b/doc/doxygen/openvpn.doxyfile<br> deleted file mode 100644<br> index a7d9728..0000000<br> --- a/doc/doxygen/openvpn.doxyfile<br> +++ /dev/null<br> @@ -1,279 +0,0 @@<br> -# Doxyfile 1.5.5<br> -<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# Project related configuration options<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -DOXYFILE_ENCODING = UTF-8<br> -PROJECT_NAME = "OpenVPN"<br> -PROJECT_NUMBER =<br> -OUTPUT_DIRECTORY = doxygen<br> -CREATE_SUBDIRS = NO<br> -OUTPUT_LANGUAGE = English<br> -BRIEF_MEMBER_DESC = YES<br> -REPEAT_BRIEF = YES<br> -ABBREVIATE_BRIEF = "The $name class" \<br> - "The $name widget" \<br> - "The $name file" \<br> - is \<br> - provides \<br> - specifies \<br> - contains \<br> - represents \<br> - a \<br> - an \<br> - the<br> -ALWAYS_DETAILED_SEC = NO<br> -INLINE_INHERITED_MEMB = NO<br> -FULL_PATH_NAMES = YES<br> -STRIP_FROM_PATH = ""<br> -STRIP_FROM_INC_PATH =<br> -SHORT_NAMES = NO<br> -JAVADOC_AUTOBRIEF = YES # NO<br> -QT_AUTOBRIEF = NO<br> -MULTILINE_CPP_IS_BRIEF = NO<br> -DETAILS_AT_TOP = NO<br> -INHERIT_DOCS = YES<br> -SEPARATE_MEMBER_PAGES = NO<br> -TAB_SIZE = 8<br> -ALIASES =<br> -OPTIMIZE_OUTPUT_FOR_C = YES<br> -OPTIMIZE_OUTPUT_JAVA = NO<br> -OPTIMIZE_FOR_FORTRAN = NO<br> -OPTIMIZE_OUTPUT_VHDL = NO<br> -BUILTIN_STL_SUPPORT = NO<br> -CPP_CLI_SUPPORT = NO<br> -SIP_SUPPORT = NO<br> -DISTRIBUTE_GROUP_DOC = NO<br> -SUBGROUPING = YES<br> -TYPEDEF_HIDES_STRUCT = NO<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# Build related configuration options<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -EXTRACT_ALL = YES<br> -EXTRACT_PRIVATE = YES<br> -EXTRACT_STATIC = YES<br> -EXTRACT_LOCAL_CLASSES = YES<br> -EXTRACT_LOCAL_METHODS = YES<br> -EXTRACT_ANON_NSPACES = YES<br> -HIDE_UNDOC_MEMBERS = NO<br> -HIDE_UNDOC_CLASSES = NO<br> -HIDE_FRIEND_COMPOUNDS = NO<br> -HIDE_IN_BODY_DOCS = NO<br> -INTERNAL_DOCS = NO<br> -CASE_SENSE_NAMES = NO<br> -HIDE_SCOPE_NAMES = NO<br> -SHOW_INCLUDE_FILES = YES<br> -INLINE_INFO = YES<br> -SORT_MEMBER_DOCS = YES<br> -SORT_BRIEF_DOCS = NO<br> -SORT_GROUP_NAMES = NO<br> -SORT_BY_SCOPE_NAME = NO<br> -GENERATE_TODOLIST = YES<br> -GENERATE_TESTLIST = YES<br> -GENERATE_BUGLIST = YES<br> -GENERATE_DEPRECATEDLIST= YES<br> -ENABLED_SECTIONS =<br> -MAX_INITIALIZER_LINES = 30<br> -SHOW_USED_FILES = YES<br> -SHOW_DIRECTORIES = NO<br> -FILE_VERSION_FILTER =<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# configuration options related to warning and progress messages<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -QUIET = NO<br> -WARNINGS = YES<br> -WARN_IF_UNDOCUMENTED = YES<br> -WARN_IF_DOC_ERROR = YES<br> -WARN_NO_PARAMDOC = NO<br> -WARN_FORMAT = "$file:$line: $text"<br> -WARN_LOGFILE =<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# configuration options related to the input files<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -INPUT = .<br> -INPUT_ENCODING = UTF-8<br> -FILE_PATTERNS = *.c \<br> - *.cc \<br> - *.cxx \<br> - *.cpp \<br> - *.c++ \<br> - *.d \<br> - *.java \<br> - *.ii \<br> - *.ixx \<br> - *.ipp \<br> - *.i++ \<br> - *.inl \<br> - *.h \<br> - *.hh \<br> - *.hxx \<br> - *.hpp \<br> - *.h++ \<br> - *.idl \<br> - *.odl \<br> - *.cs \<br> - *.php \<br> - *.php3 \<br> - *.inc \<br> - *.m \<br> - *.mm \<br> - *.dox \<br> - *.py \<br> - *.f90 \<br> - *.f \<br> - *.vhd \<br> - *.vhdl<br> -RECURSIVE = YES<br> -EXCLUDE =<br> -EXCLUDE_SYMLINKS = NO<br> -EXCLUDE_PATTERNS =<br> -EXCLUDE_SYMBOLS =<br> -EXAMPLE_PATH =<br> -EXAMPLE_PATTERNS = *<br> -EXAMPLE_RECURSIVE = NO<br> -IMAGE_PATH =<br> -INPUT_FILTER =<br> -FILTER_PATTERNS =<br> -FILTER_SOURCE_FILES = NO<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# configuration options related to source browsing<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -SOURCE_BROWSER = YES<br> -INLINE_SOURCES = NO<br> -STRIP_CODE_COMMENTS = YES<br> -REFERENCED_BY_RELATION = YES<br> -REFERENCES_RELATION = YES<br> -REFERENCES_LINK_SOURCE = YES<br> -USE_HTAGS = NO<br> -VERBATIM_HEADERS = YES<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# configuration options related to the alphabetical class index<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -ALPHABETICAL_INDEX = NO<br> -COLS_IN_ALPHA_INDEX = 5<br> -IGNORE_PREFIX =<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# configuration options related to the HTML output<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -GENERATE_HTML = YES<br> -HTML_OUTPUT = html<br> -HTML_FILE_EXTENSION = .html<br> -HTML_HEADER =<br> -HTML_FOOTER =<br> -HTML_STYLESHEET =<br> -HTML_ALIGN_MEMBERS = YES<br> -GENERATE_HTMLHELP = NO<br> -GENERATE_DOCSET = NO<br> -DOCSET_FEEDNAME = "Doxygen generated docs"<br> -DOCSET_BUNDLE_ID = org.doxygen.Project<br> -HTML_DYNAMIC_SECTIONS = NO<br> -CHM_FILE =<br> -HHC_LOCATION =<br> -GENERATE_CHI = NO<br> -BINARY_TOC = NO<br> -TOC_EXPAND = NO<br> -DISABLE_INDEX = NO<br> -ENUM_VALUES_PER_LINE = 4<br> -GENERATE_TREEVIEW = NO<br> -TREEVIEW_WIDTH = 250<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# configuration options related to the LaTeX output<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -GENERATE_LATEX = YES<br> -LATEX_OUTPUT = latex<br> -LATEX_CMD_NAME = latex<br> -MAKEINDEX_CMD_NAME = makeindex<br> -COMPACT_LATEX = YES # NO<br> -PAPER_TYPE = a4wide<br> -EXTRA_PACKAGES =<br> -LATEX_HEADER =<br> -PDF_HYPERLINKS = YES<br> -USE_PDFLATEX = YES<br> -LATEX_BATCHMODE = NO<br> -LATEX_HIDE_INDICES = NO<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# configuration options related to the RTF output<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -GENERATE_RTF = NO<br> -RTF_OUTPUT = rtf<br> -COMPACT_RTF = NO<br> -RTF_HYPERLINKS = NO<br> -RTF_STYLESHEET_FILE =<br> -RTF_EXTENSIONS_FILE =<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# configuration options related to the man page output<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -GENERATE_MAN = NO<br> -MAN_OUTPUT = man<br> -MAN_EXTENSION = .3<br> -MAN_LINKS = NO<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# configuration options related to the XML output<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -GENERATE_XML = NO<br> -XML_OUTPUT = xml<br> -XML_SCHEMA =<br> -XML_DTD =<br> -XML_PROGRAMLISTING = YES<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# configuration options for the AutoGen Definitions output<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -GENERATE_AUTOGEN_DEF = NO<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# configuration options related to the Perl module output<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -GENERATE_PERLMOD = NO<br> -PERLMOD_LATEX = NO<br> -PERLMOD_PRETTY = YES<br> -PERLMOD_MAKEVAR_PREFIX =<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# Configuration options related to the preprocessor<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -ENABLE_PREPROCESSING = YES<br> -MACRO_EXPANSION = NO<br> -EXPAND_ONLY_PREDEF = NO<br> -SEARCH_INCLUDES = YES<br> -INCLUDE_PATH =<br> -INCLUDE_FILE_PATTERNS =<br> -PREDEFINED = _WIN32 NTLM USE_LZO ENABLE_FRAGMENT P2MP P2MP_SERVER ENABLE_CRYPTO ENABLE_CRYPTO_OPENSSL ENABLE_PLUGIN ENABLE_MANAGEMENT ENABLE_OCC HAVE_GETTIMEOFDAY<br> -EXPAND_AS_DEFINED =<br> -SKIP_FUNCTION_MACROS = YES<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# Configuration::additions related to external references<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -TAGFILES =<br> -GENERATE_TAGFILE =<br> -ALLEXTERNALS = NO<br> -EXTERNAL_GROUPS = YES<br> -PERL_PATH = /usr/bin/perl<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# Configuration options related to the dot tool<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -CLASS_DIAGRAMS = NO<br> -MSCGEN_PATH =<br> -HIDE_UNDOC_RELATIONS = YES<br> -HAVE_DOT = YES<br> -CLASS_GRAPH = YES<br> -COLLABORATION_GRAPH = YES<br> -GROUP_GRAPHS = YES<br> -UML_LOOK = NO<br> -TEMPLATE_RELATIONS = NO<br> -INCLUDE_GRAPH = YES<br> -INCLUDED_BY_GRAPH = YES<br> -CALL_GRAPH = NO # YES<br> -CALLER_GRAPH = NO # YES<br> -GRAPHICAL_HIERARCHY = YES<br> -DIRECTORY_GRAPH = YES<br> -DOT_IMAGE_FORMAT = png<br> -DOT_PATH = "/usr/bin/dot"<br> -DOTFILE_DIRS =<br> -DOT_GRAPH_MAX_NODES = 50<br> -MAX_DOT_GRAPH_DEPTH = 1000<br> -DOT_TRANSPARENT = YES<br> -DOT_MULTI_TARGETS = NO<br> -GENERATE_LEGEND = YES<br> -DOT_CLEANUP = YES<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -# Configuration::additions related to the search engine<br> -#----------------------------<wbr>------------------------------<wbr>-----------------<br> -SEARCHENGINE = NO<br> diff --git a/doc/doxygen/<a href="http://openvpn.doxyfile.in" rel="noreferrer" target="_blank">openvpn.<wbr>doxyfile.in</a> b/doc/doxygen/<a href="http://openvpn.doxyfile.in" rel="noreferrer" target="_blank">openvpn.<wbr>doxyfile.in</a><br> new file mode 100644<br> index 0000000..e1cdc3b<br> --- /dev/null<br> +++ b/doc/doxygen/<a href="http://openvpn.doxyfile.in" rel="noreferrer" target="_blank">openvpn.<wbr>doxyfile.in</a><br> @@ -0,0 +1,279 @@<br> +# Doxyfile 1.5.5<br> +<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# Project related configuration options<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +DOXYFILE_ENCODING = UTF-8<br> +PROJECT_NAME = "OpenVPN"<br> +PROJECT_NUMBER =<br> +OUTPUT_DIRECTORY = doxygen<br> +CREATE_SUBDIRS = NO<br> +OUTPUT_LANGUAGE = English<br> +BRIEF_MEMBER_DESC = YES<br> +REPEAT_BRIEF = YES<br> +ABBREVIATE_BRIEF = "The $name class" \<br> + "The $name widget" \<br> + "The $name file" \<br> + is \<br> + provides \<br> + specifies \<br> + contains \<br> + represents \<br> + a \<br> + an \<br> + the<br> +ALWAYS_DETAILED_SEC = NO<br> +INLINE_INHERITED_MEMB = NO<br> +FULL_PATH_NAMES = YES<br> +STRIP_FROM_PATH = @abs_top_srcdir@<br> +STRIP_FROM_INC_PATH =<br> +SHORT_NAMES = NO<br> +JAVADOC_AUTOBRIEF = YES # NO<br> +QT_AUTOBRIEF = NO<br> +MULTILINE_CPP_IS_BRIEF = NO<br> +DETAILS_AT_TOP = NO<br> +INHERIT_DOCS = YES<br> +SEPARATE_MEMBER_PAGES = NO<br> +TAB_SIZE = 8<br> +ALIASES =<br> +OPTIMIZE_OUTPUT_FOR_C = YES<br> +OPTIMIZE_OUTPUT_JAVA = NO<br> +OPTIMIZE_FOR_FORTRAN = NO<br> +OPTIMIZE_OUTPUT_VHDL = NO<br> +BUILTIN_STL_SUPPORT = NO<br> +CPP_CLI_SUPPORT = NO<br> +SIP_SUPPORT = NO<br> +DISTRIBUTE_GROUP_DOC = NO<br> +SUBGROUPING = YES<br> +TYPEDEF_HIDES_STRUCT = NO<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# Build related configuration options<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +EXTRACT_ALL = YES<br> +EXTRACT_PRIVATE = YES<br> +EXTRACT_STATIC = YES<br> +EXTRACT_LOCAL_CLASSES = YES<br> +EXTRACT_LOCAL_METHODS = YES<br> +EXTRACT_ANON_NSPACES = YES<br> +HIDE_UNDOC_MEMBERS = NO<br> +HIDE_UNDOC_CLASSES = NO<br> +HIDE_FRIEND_COMPOUNDS = NO<br> +HIDE_IN_BODY_DOCS = NO<br> +INTERNAL_DOCS = NO<br> +CASE_SENSE_NAMES = NO<br> +HIDE_SCOPE_NAMES = NO<br> +SHOW_INCLUDE_FILES = YES<br> +INLINE_INFO = YES<br> +SORT_MEMBER_DOCS = YES<br> +SORT_BRIEF_DOCS = NO<br> +SORT_GROUP_NAMES = NO<br> +SORT_BY_SCOPE_NAME = NO<br> +GENERATE_TODOLIST = YES<br> +GENERATE_TESTLIST = YES<br> +GENERATE_BUGLIST = YES<br> +GENERATE_DEPRECATEDLIST= YES<br> +ENABLED_SECTIONS =<br> +MAX_INITIALIZER_LINES = 30<br> +SHOW_USED_FILES = YES<br> +SHOW_DIRECTORIES = NO<br> +FILE_VERSION_FILTER =<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# configuration options related to warning and progress messages<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +QUIET = NO<br> +WARNINGS = YES<br> +WARN_IF_UNDOCUMENTED = YES<br> +WARN_IF_DOC_ERROR = YES<br> +WARN_NO_PARAMDOC = NO<br> +WARN_FORMAT = "$file:$line: $text"<br> +WARN_LOGFILE =<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# configuration options related to the input files<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +INPUT = @abs_top_srcdir@<br> +INPUT_ENCODING = UTF-8<br> +FILE_PATTERNS = *.c \<br> + *.cc \<br> + *.cxx \<br> + *.cpp \<br> + *.c++ \<br> + *.d \<br> + *.java \<br> + *.ii \<br> + *.ixx \<br> + *.ipp \<br> + *.i++ \<br> + *.inl \<br> + *.h \<br> + *.hh \<br> + *.hxx \<br> + *.hpp \<br> + *.h++ \<br> + *.idl \<br> + *.odl \<br> + *.cs \<br> + *.php \<br> + *.php3 \<br> + *.inc \<br> + *.m \<br> + *.mm \<br> + *.dox \<br> + *.py \<br> + *.f90 \<br> + *.f \<br> + *.vhd \<br> + *.vhdl<br> +RECURSIVE = YES<br> +EXCLUDE =<br> +EXCLUDE_SYMLINKS = NO<br> +EXCLUDE_PATTERNS =<br> +EXCLUDE_SYMBOLS =<br> +EXAMPLE_PATH =<br> +EXAMPLE_PATTERNS = *<br> +EXAMPLE_RECURSIVE = NO<br> +IMAGE_PATH =<br> +INPUT_FILTER =<br> +FILTER_PATTERNS =<br> +FILTER_SOURCE_FILES = NO<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# configuration options related to source browsing<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +SOURCE_BROWSER = YES<br> +INLINE_SOURCES = NO<br> +STRIP_CODE_COMMENTS = YES<br> +REFERENCED_BY_RELATION = YES<br> +REFERENCES_RELATION = YES<br> +REFERENCES_LINK_SOURCE = YES<br> +USE_HTAGS = NO<br> +VERBATIM_HEADERS = YES<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# configuration options related to the alphabetical class index<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +ALPHABETICAL_INDEX = NO<br> +COLS_IN_ALPHA_INDEX = 5<br> +IGNORE_PREFIX =<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# configuration options related to the HTML output<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +GENERATE_HTML = YES<br> +HTML_OUTPUT = html<br> +HTML_FILE_EXTENSION = .html<br> +HTML_HEADER =<br> +HTML_FOOTER =<br> +HTML_STYLESHEET =<br> +HTML_ALIGN_MEMBERS = YES<br> +GENERATE_HTMLHELP = NO<br> +GENERATE_DOCSET = NO<br> +DOCSET_FEEDNAME = "Doxygen generated docs"<br> +DOCSET_BUNDLE_ID = org.doxygen.Project<br> +HTML_DYNAMIC_SECTIONS = NO<br> +CHM_FILE =<br> +HHC_LOCATION =<br> +GENERATE_CHI = NO<br> +BINARY_TOC = NO<br> +TOC_EXPAND = NO<br> +DISABLE_INDEX = NO<br> +ENUM_VALUES_PER_LINE = 4<br> +GENERATE_TREEVIEW = NO<br> +TREEVIEW_WIDTH = 250<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# configuration options related to the LaTeX output<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +GENERATE_LATEX = YES<br> +LATEX_OUTPUT = latex<br> +LATEX_CMD_NAME = latex<br> +MAKEINDEX_CMD_NAME = makeindex<br> +COMPACT_LATEX = YES # NO<br> +PAPER_TYPE = a4wide<br> +EXTRA_PACKAGES =<br> +LATEX_HEADER =<br> +PDF_HYPERLINKS = YES<br> +USE_PDFLATEX = YES<br> +LATEX_BATCHMODE = NO<br> +LATEX_HIDE_INDICES = NO<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# configuration options related to the RTF output<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +GENERATE_RTF = NO<br> +RTF_OUTPUT = rtf<br> +COMPACT_RTF = NO<br> +RTF_HYPERLINKS = NO<br> +RTF_STYLESHEET_FILE =<br> +RTF_EXTENSIONS_FILE =<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# configuration options related to the man page output<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +GENERATE_MAN = NO<br> +MAN_OUTPUT = man<br> +MAN_EXTENSION = .3<br> +MAN_LINKS = NO<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# configuration options related to the XML output<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +GENERATE_XML = NO<br> +XML_OUTPUT = xml<br> +XML_SCHEMA =<br> +XML_DTD =<br> +XML_PROGRAMLISTING = YES<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# configuration options for the AutoGen Definitions output<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +GENERATE_AUTOGEN_DEF = NO<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# configuration options related to the Perl module output<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +GENERATE_PERLMOD = NO<br> +PERLMOD_LATEX = NO<br> +PERLMOD_PRETTY = YES<br> +PERLMOD_MAKEVAR_PREFIX =<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# Configuration options related to the preprocessor<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +ENABLE_PREPROCESSING = YES<br> +MACRO_EXPANSION = NO<br> +EXPAND_ONLY_PREDEF = NO<br> +SEARCH_INCLUDES = YES<br> +INCLUDE_PATH =<br> +INCLUDE_FILE_PATTERNS =<br> +PREDEFINED = _WIN32 NTLM USE_LZO ENABLE_FRAGMENT P2MP P2MP_SERVER ENABLE_CRYPTO ENABLE_CRYPTO_OPENSSL ENABLE_PLUGIN ENABLE_MANAGEMENT ENABLE_OCC HAVE_GETTIMEOFDAY<br> +EXPAND_AS_DEFINED =<br> +SKIP_FUNCTION_MACROS = YES<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# Configuration::additions related to external references<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +TAGFILES =<br> +GENERATE_TAGFILE =<br> +ALLEXTERNALS = NO<br> +EXTERNAL_GROUPS = YES<br> +PERL_PATH = /usr/bin/perl<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# Configuration options related to the dot tool<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +CLASS_DIAGRAMS = NO<br> +MSCGEN_PATH =<br> +HIDE_UNDOC_RELATIONS = YES<br> +HAVE_DOT = YES<br> +CLASS_GRAPH = YES<br> +COLLABORATION_GRAPH = YES<br> +GROUP_GRAPHS = YES<br> +UML_LOOK = NO<br> +TEMPLATE_RELATIONS = NO<br> +INCLUDE_GRAPH = YES<br> +INCLUDED_BY_GRAPH = YES<br> +CALL_GRAPH = NO # YES<br> +CALLER_GRAPH = NO # YES<br> +GRAPHICAL_HIERARCHY = YES<br> +DIRECTORY_GRAPH = YES<br> +DOT_IMAGE_FORMAT = png<br> +DOT_PATH = "/usr/bin/dot"<br> +DOTFILE_DIRS =<br> +DOT_GRAPH_MAX_NODES = 50<br> +MAX_DOT_GRAPH_DEPTH = 1000<br> +DOT_TRANSPARENT = YES<br> +DOT_MULTI_TARGETS = NO<br> +GENERATE_LEGEND = YES<br> +DOT_CLEANUP = YES<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +# Configuration::additions related to the search engine<br> +#----------------------------<wbr>------------------------------<wbr>-----------------<br> +SEARCHENGINE = NO<br> <span class="gmail-HOEnZb"><font color="#888888">--<br> 2.7.4<br> <br> <br> ------------------------------<wbr>------------------------------<wbr>------------------<br> Check out the vibrant tech community on one of the world's most<br> engaging tech sites, Slashdot.org! <a href="http://sdm.link/slashdot" rel="noreferrer" target="_blank">http://sdm.link/slashdot</a><br> ______________________________<wbr>_________________<br> Openvpn-devel mailing list<br> <a href="mailto:Openvpn-devel@lists.sourceforge.net">Openvpn-devel@lists.<wbr>sourceforge.net</a><br> <a href="https://lists.sourceforge.net/lists/listinfo/openvpn-devel" rel="noreferrer" target="_blank">https://lists.sourceforge.net/<wbr>lists/listinfo/openvpn-devel</a><br> </font></span></blockquote></div><br></div></div> ------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot
diff --git a/Makefile.am b/Makefile.am index 87af724..34632c4 100644 --- a/Makefile.am +++ b/Makefile.am @@ -46,7 +46,7 @@ EXTRA_DIST = \ contrib \ debug -.PHONY: config-version.h +.PHONY: config-version.h doxygen if GIT_CHECKOUT BUILT_SOURCES = \ @@ -96,3 +96,6 @@ config-version.h: else \ rm -f config-version.h.tmp; \ fi + +doxygen: doc/doxygen/openvpn.doxyfile + doxygen doc/doxygen/openvpn.doxyfile diff --git a/configure.ac b/configure.ac index 45aa501..eca83e6 100644 --- a/configure.ac +++ b/configure.ac @@ -1420,6 +1420,7 @@ AC_CONFIG_FILES([ distro/rpm/Makefile distro/rpm/openvpn.spec distro/systemd/Makefile + doc/doxygen/openvpn.doxyfile include/Makefile src/Makefile src/compat/Makefile diff --git a/doc/Makefile.am b/doc/Makefile.am index dedd1fa..f9e7f4a 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -14,6 +14,8 @@ MAINTAINERCLEANFILES = \ CLEANFILES = openvpn.8.html +SUBDIRS = doxygen + dist_doc_DATA = \ management-notes.txt diff --git a/doc/doxygen/openvpn.doxyfile b/doc/doxygen/openvpn.doxyfile deleted file mode 100644 index a7d9728..0000000 --- a/doc/doxygen/openvpn.doxyfile +++ /dev/null @@ -1,279 +0,0 @@ -# Doxyfile 1.5.5 - -#--------------------------------------------------------------------------- -# Project related configuration options -#--------------------------------------------------------------------------- -DOXYFILE_ENCODING = UTF-8 -PROJECT_NAME = "OpenVPN" -PROJECT_NUMBER = -OUTPUT_DIRECTORY = doxygen -CREATE_SUBDIRS = NO -OUTPUT_LANGUAGE = English -BRIEF_MEMBER_DESC = YES -REPEAT_BRIEF = YES -ABBREVIATE_BRIEF = "The $name class" \ - "The $name widget" \ - "The $name file" \ - is \ - provides \ - specifies \ - contains \ - represents \ - a \ - an \ - the -ALWAYS_DETAILED_SEC = NO -INLINE_INHERITED_MEMB = NO -FULL_PATH_NAMES = YES -STRIP_FROM_PATH = "" -STRIP_FROM_INC_PATH = -SHORT_NAMES = NO -JAVADOC_AUTOBRIEF = YES # NO -QT_AUTOBRIEF = NO -MULTILINE_CPP_IS_BRIEF = NO -DETAILS_AT_TOP = NO -INHERIT_DOCS = YES -SEPARATE_MEMBER_PAGES = NO -TAB_SIZE = 8 -ALIASES = -OPTIMIZE_OUTPUT_FOR_C = YES -OPTIMIZE_OUTPUT_JAVA = NO -OPTIMIZE_FOR_FORTRAN = NO -OPTIMIZE_OUTPUT_VHDL = NO -BUILTIN_STL_SUPPORT = NO -CPP_CLI_SUPPORT = NO -SIP_SUPPORT = NO -DISTRIBUTE_GROUP_DOC = NO -SUBGROUPING = YES -TYPEDEF_HIDES_STRUCT = NO -#--------------------------------------------------------------------------- -# Build related configuration options -#--------------------------------------------------------------------------- -EXTRACT_ALL = YES -EXTRACT_PRIVATE = YES -EXTRACT_STATIC = YES -EXTRACT_LOCAL_CLASSES = YES -EXTRACT_LOCAL_METHODS = YES -EXTRACT_ANON_NSPACES = YES -HIDE_UNDOC_MEMBERS = NO -HIDE_UNDOC_CLASSES = NO -HIDE_FRIEND_COMPOUNDS = NO -HIDE_IN_BODY_DOCS = NO -INTERNAL_DOCS = NO -CASE_SENSE_NAMES = NO -HIDE_SCOPE_NAMES = NO -SHOW_INCLUDE_FILES = YES -INLINE_INFO = YES -SORT_MEMBER_DOCS = YES -SORT_BRIEF_DOCS = NO -SORT_GROUP_NAMES = NO -SORT_BY_SCOPE_NAME = NO -GENERATE_TODOLIST = YES -GENERATE_TESTLIST = YES -GENERATE_BUGLIST = YES -GENERATE_DEPRECATEDLIST= YES -ENABLED_SECTIONS = -MAX_INITIALIZER_LINES = 30 -SHOW_USED_FILES = YES -SHOW_DIRECTORIES = NO -FILE_VERSION_FILTER = -#--------------------------------------------------------------------------- -# configuration options related to warning and progress messages -#--------------------------------------------------------------------------- -QUIET = NO -WARNINGS = YES -WARN_IF_UNDOCUMENTED = YES -WARN_IF_DOC_ERROR = YES -WARN_NO_PARAMDOC = NO -WARN_FORMAT = "$file:$line: $text" -WARN_LOGFILE = -#--------------------------------------------------------------------------- -# configuration options related to the input files -#--------------------------------------------------------------------------- -INPUT = . -INPUT_ENCODING = UTF-8 -FILE_PATTERNS = *.c \ - *.cc \ - *.cxx \ - *.cpp \ - *.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 -RECURSIVE = YES -EXCLUDE = -EXCLUDE_SYMLINKS = NO -EXCLUDE_PATTERNS = -EXCLUDE_SYMBOLS = -EXAMPLE_PATH = -EXAMPLE_PATTERNS = * -EXAMPLE_RECURSIVE = NO -IMAGE_PATH = -INPUT_FILTER = -FILTER_PATTERNS = -FILTER_SOURCE_FILES = NO -#--------------------------------------------------------------------------- -# configuration options related to source browsing -#--------------------------------------------------------------------------- -SOURCE_BROWSER = YES -INLINE_SOURCES = NO -STRIP_CODE_COMMENTS = YES -REFERENCED_BY_RELATION = YES -REFERENCES_RELATION = YES -REFERENCES_LINK_SOURCE = YES -USE_HTAGS = NO -VERBATIM_HEADERS = YES -#--------------------------------------------------------------------------- -# configuration options related to the alphabetical class index -#--------------------------------------------------------------------------- -ALPHABETICAL_INDEX = NO -COLS_IN_ALPHA_INDEX = 5 -IGNORE_PREFIX = -#--------------------------------------------------------------------------- -# configuration options related to the HTML output -#--------------------------------------------------------------------------- -GENERATE_HTML = YES -HTML_OUTPUT = html -HTML_FILE_EXTENSION = .html -HTML_HEADER = -HTML_FOOTER = -HTML_STYLESHEET = -HTML_ALIGN_MEMBERS = YES -GENERATE_HTMLHELP = NO -GENERATE_DOCSET = NO -DOCSET_FEEDNAME = "Doxygen generated docs" -DOCSET_BUNDLE_ID = org.doxygen.Project -HTML_DYNAMIC_SECTIONS = NO -CHM_FILE = -HHC_LOCATION = -GENERATE_CHI = NO -BINARY_TOC = NO -TOC_EXPAND = NO -DISABLE_INDEX = NO -ENUM_VALUES_PER_LINE = 4 -GENERATE_TREEVIEW = NO -TREEVIEW_WIDTH = 250 -#--------------------------------------------------------------------------- -# configuration options related to the LaTeX output -#--------------------------------------------------------------------------- -GENERATE_LATEX = YES -LATEX_OUTPUT = latex -LATEX_CMD_NAME = latex -MAKEINDEX_CMD_NAME = makeindex -COMPACT_LATEX = YES # NO -PAPER_TYPE = a4wide -EXTRA_PACKAGES = -LATEX_HEADER = -PDF_HYPERLINKS = YES -USE_PDFLATEX = YES -LATEX_BATCHMODE = NO -LATEX_HIDE_INDICES = NO -#--------------------------------------------------------------------------- -# configuration options related to the RTF output -#--------------------------------------------------------------------------- -GENERATE_RTF = NO -RTF_OUTPUT = rtf -COMPACT_RTF = NO -RTF_HYPERLINKS = NO -RTF_STYLESHEET_FILE = -RTF_EXTENSIONS_FILE = -#--------------------------------------------------------------------------- -# configuration options related to the man page output -#--------------------------------------------------------------------------- -GENERATE_MAN = NO -MAN_OUTPUT = man -MAN_EXTENSION = .3 -MAN_LINKS = NO -#--------------------------------------------------------------------------- -# configuration options related to the XML output -#--------------------------------------------------------------------------- -GENERATE_XML = NO -XML_OUTPUT = xml -XML_SCHEMA = -XML_DTD = -XML_PROGRAMLISTING = YES -#--------------------------------------------------------------------------- -# configuration options for the AutoGen Definitions output -#--------------------------------------------------------------------------- -GENERATE_AUTOGEN_DEF = NO -#--------------------------------------------------------------------------- -# configuration options related to the Perl module output -#--------------------------------------------------------------------------- -GENERATE_PERLMOD = NO -PERLMOD_LATEX = NO -PERLMOD_PRETTY = YES -PERLMOD_MAKEVAR_PREFIX = -#--------------------------------------------------------------------------- -# Configuration options related to the preprocessor -#--------------------------------------------------------------------------- -ENABLE_PREPROCESSING = YES -MACRO_EXPANSION = NO -EXPAND_ONLY_PREDEF = NO -SEARCH_INCLUDES = YES -INCLUDE_PATH = -INCLUDE_FILE_PATTERNS = -PREDEFINED = _WIN32 NTLM USE_LZO ENABLE_FRAGMENT P2MP P2MP_SERVER ENABLE_CRYPTO ENABLE_CRYPTO_OPENSSL ENABLE_PLUGIN ENABLE_MANAGEMENT ENABLE_OCC HAVE_GETTIMEOFDAY -EXPAND_AS_DEFINED = -SKIP_FUNCTION_MACROS = YES -#--------------------------------------------------------------------------- -# Configuration::additions related to external references -#--------------------------------------------------------------------------- -TAGFILES = -GENERATE_TAGFILE = -ALLEXTERNALS = NO -EXTERNAL_GROUPS = YES -PERL_PATH = /usr/bin/perl -#--------------------------------------------------------------------------- -# Configuration options related to the dot tool -#--------------------------------------------------------------------------- -CLASS_DIAGRAMS = NO -MSCGEN_PATH = -HIDE_UNDOC_RELATIONS = YES -HAVE_DOT = YES -CLASS_GRAPH = YES -COLLABORATION_GRAPH = YES -GROUP_GRAPHS = YES -UML_LOOK = NO -TEMPLATE_RELATIONS = NO -INCLUDE_GRAPH = YES -INCLUDED_BY_GRAPH = YES -CALL_GRAPH = NO # YES -CALLER_GRAPH = NO # YES -GRAPHICAL_HIERARCHY = YES -DIRECTORY_GRAPH = YES -DOT_IMAGE_FORMAT = png -DOT_PATH = "/usr/bin/dot" -DOTFILE_DIRS = -DOT_GRAPH_MAX_NODES = 50 -MAX_DOT_GRAPH_DEPTH = 1000 -DOT_TRANSPARENT = YES -DOT_MULTI_TARGETS = NO -GENERATE_LEGEND = YES -DOT_CLEANUP = YES -#--------------------------------------------------------------------------- -# Configuration::additions related to the search engine -#--------------------------------------------------------------------------- -SEARCHENGINE = NO diff --git a/doc/doxygen/openvpn.doxyfile.in b/doc/doxygen/openvpn.doxyfile.in new file mode 100644 index 0000000..e1cdc3b --- /dev/null +++ b/doc/doxygen/openvpn.doxyfile.in @@ -0,0 +1,279 @@ +# Doxyfile 1.5.5 + +#--------------------------------------------------------------------------- +# Project related configuration options +#--------------------------------------------------------------------------- +DOXYFILE_ENCODING = UTF-8 +PROJECT_NAME = "OpenVPN" +PROJECT_NUMBER = +OUTPUT_DIRECTORY = doxygen +CREATE_SUBDIRS = NO +OUTPUT_LANGUAGE = English +BRIEF_MEMBER_DESC = YES +REPEAT_BRIEF = YES +ABBREVIATE_BRIEF = "The $name class" \ + "The $name widget" \ + "The $name file" \ + is \ + provides \ + specifies \ + contains \ + represents \ + a \ + an \ + the +ALWAYS_DETAILED_SEC = NO +INLINE_INHERITED_MEMB = NO +FULL_PATH_NAMES = YES +STRIP_FROM_PATH = @abs_top_srcdir@ +STRIP_FROM_INC_PATH = +SHORT_NAMES = NO +JAVADOC_AUTOBRIEF = YES # NO +QT_AUTOBRIEF = NO +MULTILINE_CPP_IS_BRIEF = NO +DETAILS_AT_TOP = NO +INHERIT_DOCS = YES +SEPARATE_MEMBER_PAGES = NO +TAB_SIZE = 8 +ALIASES = +OPTIMIZE_OUTPUT_FOR_C = YES +OPTIMIZE_OUTPUT_JAVA = NO +OPTIMIZE_FOR_FORTRAN = NO +OPTIMIZE_OUTPUT_VHDL = NO +BUILTIN_STL_SUPPORT = NO +CPP_CLI_SUPPORT = NO +SIP_SUPPORT = NO +DISTRIBUTE_GROUP_DOC = NO +SUBGROUPING = YES +TYPEDEF_HIDES_STRUCT = NO +#--------------------------------------------------------------------------- +# Build related configuration options +#--------------------------------------------------------------------------- +EXTRACT_ALL = YES +EXTRACT_PRIVATE = YES +EXTRACT_STATIC = YES +EXTRACT_LOCAL_CLASSES = YES +EXTRACT_LOCAL_METHODS = YES +EXTRACT_ANON_NSPACES = YES +HIDE_UNDOC_MEMBERS = NO +HIDE_UNDOC_CLASSES = NO +HIDE_FRIEND_COMPOUNDS = NO +HIDE_IN_BODY_DOCS = NO +INTERNAL_DOCS = NO +CASE_SENSE_NAMES = NO +HIDE_SCOPE_NAMES = NO +SHOW_INCLUDE_FILES = YES +INLINE_INFO = YES +SORT_MEMBER_DOCS = YES +SORT_BRIEF_DOCS = NO +SORT_GROUP_NAMES = NO +SORT_BY_SCOPE_NAME = NO +GENERATE_TODOLIST = YES +GENERATE_TESTLIST = YES +GENERATE_BUGLIST = YES +GENERATE_DEPRECATEDLIST= YES +ENABLED_SECTIONS = +MAX_INITIALIZER_LINES = 30 +SHOW_USED_FILES = YES +SHOW_DIRECTORIES = NO +FILE_VERSION_FILTER = +#--------------------------------------------------------------------------- +# configuration options related to warning and progress messages +#--------------------------------------------------------------------------- +QUIET = NO +WARNINGS = YES +WARN_IF_UNDOCUMENTED = YES +WARN_IF_DOC_ERROR = YES +WARN_NO_PARAMDOC = NO +WARN_FORMAT = "$file:$line: $text" +WARN_LOGFILE = +#--------------------------------------------------------------------------- +# configuration options related to the input files +#--------------------------------------------------------------------------- +INPUT = @abs_top_srcdir@ +INPUT_ENCODING = UTF-8 +FILE_PATTERNS = *.c \ + *.cc \ + *.cxx \ + *.cpp \ + *.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 +RECURSIVE = YES +EXCLUDE = +EXCLUDE_SYMLINKS = NO +EXCLUDE_PATTERNS = +EXCLUDE_SYMBOLS = +EXAMPLE_PATH = +EXAMPLE_PATTERNS = * +EXAMPLE_RECURSIVE = NO +IMAGE_PATH = +INPUT_FILTER = +FILTER_PATTERNS = +FILTER_SOURCE_FILES = NO +#--------------------------------------------------------------------------- +# configuration options related to source browsing +#--------------------------------------------------------------------------- +SOURCE_BROWSER = YES +INLINE_SOURCES = NO +STRIP_CODE_COMMENTS = YES +REFERENCED_BY_RELATION = YES +REFERENCES_RELATION = YES +REFERENCES_LINK_SOURCE = YES +USE_HTAGS = NO +VERBATIM_HEADERS = YES +#--------------------------------------------------------------------------- +# configuration options related to the alphabetical class index +#--------------------------------------------------------------------------- +ALPHABETICAL_INDEX = NO +COLS_IN_ALPHA_INDEX = 5 +IGNORE_PREFIX = +#--------------------------------------------------------------------------- +# configuration options related to the HTML output +#--------------------------------------------------------------------------- +GENERATE_HTML = YES +HTML_OUTPUT = html +HTML_FILE_EXTENSION = .html +HTML_HEADER = +HTML_FOOTER = +HTML_STYLESHEET = +HTML_ALIGN_MEMBERS = YES +GENERATE_HTMLHELP = NO +GENERATE_DOCSET = NO +DOCSET_FEEDNAME = "Doxygen generated docs" +DOCSET_BUNDLE_ID = org.doxygen.Project +HTML_DYNAMIC_SECTIONS = NO +CHM_FILE = +HHC_LOCATION = +GENERATE_CHI = NO +BINARY_TOC = NO +TOC_EXPAND = NO +DISABLE_INDEX = NO +ENUM_VALUES_PER_LINE = 4 +GENERATE_TREEVIEW = NO +TREEVIEW_WIDTH = 250 +#--------------------------------------------------------------------------- +# configuration options related to the LaTeX output +#--------------------------------------------------------------------------- +GENERATE_LATEX = YES +LATEX_OUTPUT = latex +LATEX_CMD_NAME = latex +MAKEINDEX_CMD_NAME = makeindex +COMPACT_LATEX = YES # NO +PAPER_TYPE = a4wide +EXTRA_PACKAGES = +LATEX_HEADER = +PDF_HYPERLINKS = YES +USE_PDFLATEX = YES +LATEX_BATCHMODE = NO +LATEX_HIDE_INDICES = NO +#--------------------------------------------------------------------------- +# configuration options related to the RTF output +#--------------------------------------------------------------------------- +GENERATE_RTF = NO +RTF_OUTPUT = rtf +COMPACT_RTF = NO +RTF_HYPERLINKS = NO +RTF_STYLESHEET_FILE = +RTF_EXTENSIONS_FILE = +#--------------------------------------------------------------------------- +# configuration options related to the man page output +#--------------------------------------------------------------------------- +GENERATE_MAN = NO +MAN_OUTPUT = man +MAN_EXTENSION = .3 +MAN_LINKS = NO +#--------------------------------------------------------------------------- +# configuration options related to the XML output +#--------------------------------------------------------------------------- +GENERATE_XML = NO +XML_OUTPUT = xml +XML_SCHEMA = +XML_DTD = +XML_PROGRAMLISTING = YES +#--------------------------------------------------------------------------- +# configuration options for the AutoGen Definitions output +#--------------------------------------------------------------------------- +GENERATE_AUTOGEN_DEF = NO +#--------------------------------------------------------------------------- +# configuration options related to the Perl module output +#--------------------------------------------------------------------------- +GENERATE_PERLMOD = NO +PERLMOD_LATEX = NO +PERLMOD_PRETTY = YES +PERLMOD_MAKEVAR_PREFIX = +#--------------------------------------------------------------------------- +# Configuration options related to the preprocessor +#--------------------------------------------------------------------------- +ENABLE_PREPROCESSING = YES +MACRO_EXPANSION = NO +EXPAND_ONLY_PREDEF = NO +SEARCH_INCLUDES = YES +INCLUDE_PATH = +INCLUDE_FILE_PATTERNS = +PREDEFINED = _WIN32 NTLM USE_LZO ENABLE_FRAGMENT P2MP P2MP_SERVER ENABLE_CRYPTO ENABLE_CRYPTO_OPENSSL ENABLE_PLUGIN ENABLE_MANAGEMENT ENABLE_OCC HAVE_GETTIMEOFDAY +EXPAND_AS_DEFINED = +SKIP_FUNCTION_MACROS = YES +#--------------------------------------------------------------------------- +# Configuration::additions related to external references +#--------------------------------------------------------------------------- +TAGFILES = +GENERATE_TAGFILE = +ALLEXTERNALS = NO +EXTERNAL_GROUPS = YES +PERL_PATH = /usr/bin/perl +#--------------------------------------------------------------------------- +# Configuration options related to the dot tool +#--------------------------------------------------------------------------- +CLASS_DIAGRAMS = NO +MSCGEN_PATH = +HIDE_UNDOC_RELATIONS = YES +HAVE_DOT = YES +CLASS_GRAPH = YES +COLLABORATION_GRAPH = YES +GROUP_GRAPHS = YES +UML_LOOK = NO +TEMPLATE_RELATIONS = NO +INCLUDE_GRAPH = YES +INCLUDED_BY_GRAPH = YES +CALL_GRAPH = NO # YES +CALLER_GRAPH = NO # YES +GRAPHICAL_HIERARCHY = YES +DIRECTORY_GRAPH = YES +DOT_IMAGE_FORMAT = png +DOT_PATH = "/usr/bin/dot" +DOTFILE_DIRS = +DOT_GRAPH_MAX_NODES = 50 +MAX_DOT_GRAPH_DEPTH = 1000 +DOT_TRANSPARENT = YES +DOT_MULTI_TARGETS = NO +GENERATE_LEGEND = YES +DOT_CLEANUP = YES +#--------------------------------------------------------------------------- +# Configuration::additions related to the search engine +#--------------------------------------------------------------------------- +SEARCHENGINE = NO
Add a make target, such that 'make doxygen' works (both for in-tree and out-of-tree builds). While doing so, instead of genering docs with full path names (e.g. /home/steffan/dev/openvpn/src/openvpn/crypto.h), use a relative path wrt the project root (e.g. src/openvpn/crypto.h) in the generated documentation. This makes the generated doxygen easier to read. Signed-off-by: Steffan Karger <steffan.karger@fox-it.com> --- v2: - merge patches 1/2 and 2/2 from the v1 set - use abs_top_srcdir (instead of top_srcdir) Makefile.am | 5 +- configure.ac | 1 + doc/Makefile.am | 2 + doc/doxygen/openvpn.doxyfile | 279 ---------------------------------------- doc/doxygen/openvpn.doxyfile.in | 279 ++++++++++++++++++++++++++++++++++++++++ 5 files changed, 286 insertions(+), 280 deletions(-) delete mode 100644 doc/doxygen/openvpn.doxyfile create mode 100644 doc/doxygen/openvpn.doxyfile.in