forked from Archive/PX4-Autopilot
doxygen move to cmake and cleanup (#9234)
This commit is contained in:
Daniel Agar
GitHub
parent
41b0db2860
commit
94d1593e5b
|
|
@ -412,6 +412,34 @@ add_custom_command(OUTPUT ${uorb_graph_config}
|
||||||
)
|
)
|
||||||
add_custom_target(uorb_graph DEPENDS ${uorb_graph_config})
|
add_custom_target(uorb_graph DEPENDS ${uorb_graph_config})
|
||||||
|
|
||||||
|
#=============================================================================
|
||||||
|
# Doxygen
|
||||||
|
#
|
||||||
|
option(BUILD_DOXYGEN "Build doxygen documentation" OFF)
|
||||||
|
|
||||||
|
find_package(Doxygen)
|
||||||
|
if (DOXYGEN_FOUND)
|
||||||
|
# set input and output files
|
||||||
|
set(DOXYGEN_IN ${CMAKE_SOURCE_DIR}/Documentation/Doxyfile.in)
|
||||||
|
set(DOXYGEN_OUT ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile)
|
||||||
|
|
||||||
|
# request to configure the file
|
||||||
|
configure_file(${DOXYGEN_IN} ${DOXYGEN_OUT} @ONLY)
|
||||||
|
|
||||||
|
# note the option ALL which allows to build the docs together with the application
|
||||||
|
add_custom_target(doxygen ALL
|
||||||
|
COMMAND ${DOXYGEN_EXECUTABLE} ${DOXYGEN_OUT}
|
||||||
|
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
|
||||||
|
COMMENT "Generating API documentation with Doxygen"
|
||||||
|
DEPENDS uorb_msgs parameter_headers
|
||||||
|
VERBATIM
|
||||||
|
USES_TERMINAL)
|
||||||
|
|
||||||
|
else (DOXYGEN_FOUND)
|
||||||
|
message("Doxygen need to be installed to generate the doxygen documentation")
|
||||||
|
endif (DOXYGEN_FOUND)
|
||||||
|
|
||||||
|
|
||||||
#=============================================================================
|
#=============================================================================
|
||||||
# packaging
|
# packaging
|
||||||
#
|
#
|
||||||
|
|
|
||||||
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,121 @@
|
||||||
|
# Use: `doxygen -g test.txt` to generate all possible settings for this file
|
||||||
|
|
||||||
|
# For modern doxygen style uncomment these three lines:
|
||||||
|
#HTML_EXTRA_STYLESHEET = @CMAKE_CURRENT_SOURCE_DIR@/doxygen/customdoxygen.css
|
||||||
|
#HTML_HEADER = @CMAKE_SOURCE_DIR@/Documentation/header.html
|
||||||
|
#HTML_FOOTER = @CMAKE_SOURCE_DIR@/Documentation/footer.html
|
||||||
|
|
||||||
|
# not interested build output
|
||||||
|
QUIET = YES
|
||||||
|
|
||||||
|
# Basic settings:
|
||||||
|
PROJECT_NAME = "@CMAKE_PROJECT_NAME@"
|
||||||
|
PROJECT_NUMBER = @PROJECT_VERSION_MAJOR@.@PROJECT_VERSION_MINOR@.@PROJECT_VERSION_PATCH@@VERSION_TYPE@
|
||||||
|
STRIP_FROM_PATH = @CMAKE_SOURCE_DIR@
|
||||||
|
|
||||||
|
INPUT = @CMAKE_SOURCE_DIR@/README.md \
|
||||||
|
@CMAKE_SOURCE_DIR@ \
|
||||||
|
@CMAKE_SOURCE_DIR@/src \
|
||||||
|
@CMAKE_BINARY_DIR@/ \
|
||||||
|
@CMAKE_BINARY_DIR@/uORB
|
||||||
|
|
||||||
|
FILE_PATTERNS = *.h \
|
||||||
|
*.hpp \
|
||||||
|
*.hh \
|
||||||
|
*.c \
|
||||||
|
*.cc \
|
||||||
|
*.cpp.in \
|
||||||
|
*.cpp \
|
||||||
|
*.md
|
||||||
|
|
||||||
|
RECURSIVE = YES
|
||||||
|
USE_MDFILE_AS_MAINPAGE = "@CMAKE_SOURCE_DIR@/README.md"
|
||||||
|
# output location
|
||||||
|
HTML_OUTPUT = "@CMAKE_BINARY_DIR@/Documentation"
|
||||||
|
|
||||||
|
IMAGE_PATH = "@CMAKE_SOURCE_DIR@"
|
||||||
|
|
||||||
|
# The OUTPUT_LANGUAGE tag is used to specify the language in which all
|
||||||
|
# documentation generated by doxygen is written. Doxygen will use this
|
||||||
|
# information to generate all constant output in the proper language.
|
||||||
|
# Possible values are: Afrikaans, Arabic, Armenian, Brazilian, Catalan, Chinese,
|
||||||
|
# Chinese-Traditional, Croatian, Czech, Danish, Dutch, English (United States),
|
||||||
|
# Esperanto, Farsi (Persian), Finnish, French, German, Greek, Hungarian,
|
||||||
|
# Indonesian, Italian, Japanese, Japanese-en (Japanese with English messages),
|
||||||
|
# Korean, Korean-en (Korean with English messages), Latvian, Lithuanian,
|
||||||
|
# Macedonian, Norwegian, Persian (Farsi), Polish, Portuguese, Romanian, Russian,
|
||||||
|
# Serbian, Serbian-Cyrillic, Slovak, Slovene, Spanish, Swedish, Turkish,
|
||||||
|
# Ukrainian and Vietnamese.
|
||||||
|
# The default value is: English.
|
||||||
|
OUTPUT_LANGUAGE = English
|
||||||
|
|
||||||
|
# Color style
|
||||||
|
HTML_COLORSTYLE_HUE = 220
|
||||||
|
HTML_COLORSTYLE_SAT = 40
|
||||||
|
HTML_COLORSTYLE_GAMMA = 80
|
||||||
|
|
||||||
|
# max size 200x55px
|
||||||
|
PROJECT_LOGO =
|
||||||
|
|
||||||
|
|
||||||
|
# If the REFERENCED_BY_RELATION tag is set to YES then for each documented
|
||||||
|
# function all documented functions referencing it will be listed.
|
||||||
|
# The default value is: NO.
|
||||||
|
REFERENCED_BY_RELATION = YES
|
||||||
|
|
||||||
|
# If the REFERENCES_RELATION tag is set to YES then for each documented function
|
||||||
|
# all documented entities called/used by that function will be listed.
|
||||||
|
# The default value is: NO.
|
||||||
|
REFERENCES_RELATION = YES
|
||||||
|
|
||||||
|
# This is nice to have - callgraphs of functions
|
||||||
|
HAVE_DOT = YES
|
||||||
|
CALL_GRAPH = YES
|
||||||
|
CALLER_GRAPH = YES
|
||||||
|
|
||||||
|
GRAPHICAL_HIERARCHY = YES
|
||||||
|
DIRECTORY_GRAPH = YES
|
||||||
|
GENERATE_LEGEND = YES
|
||||||
|
INCLUDED_BY_GRAPH = YES
|
||||||
|
INCLUDE_GRAPH = YES
|
||||||
|
DOT_IMAGE_FORMAT = svg
|
||||||
|
INTERACTIVE_SVG = YES
|
||||||
|
|
||||||
|
# More insight to templates, generaly not needed
|
||||||
|
TEMPLATE_RELATIONS = NO
|
||||||
|
|
||||||
|
# in class diagrams, you will have members and such
|
||||||
|
# Also they will be bigger
|
||||||
|
UML_LOOK = YES
|
||||||
|
UML_LIMIT_NUM_FIELDS = 6
|
||||||
|
|
||||||
|
# should all pictures be collapsed?
|
||||||
|
HTML_DYNAMIC_SECTIONS = NO
|
||||||
|
|
||||||
|
|
||||||
|
# use with: /// @todo Do more stuff.
|
||||||
|
GENERATE_TODOLIST = YES
|
||||||
|
|
||||||
|
# we want all we can get
|
||||||
|
EXTRACT_ALL = YES
|
||||||
|
EXTRACT_STATIC = YES
|
||||||
|
EXTRACT_PRIVATE = YES
|
||||||
|
|
||||||
|
# We do not need latex output
|
||||||
|
GENERATE_LATEX = NO
|
||||||
|
USE_PDFLATEX = NO
|
||||||
|
|
||||||
|
# this makes first sentence from comment block a brief description.
|
||||||
|
# It is VERY useful
|
||||||
|
JAVADOC_AUTOBRIEF = YES
|
||||||
|
|
||||||
|
# Why not...
|
||||||
|
BUILTIN_STL_SUPPORT = YES
|
||||||
|
|
||||||
|
# Do we want source code browser? YES! Do we want strip comments? NO
|
||||||
|
SOURCE_BROWSER = YES
|
||||||
|
STRIP_CODE_COMMENTS = NO
|
||||||
|
|
||||||
|
# Side panel
|
||||||
|
# If you enable this, change .container max-width: 960px; to 1240px
|
||||||
|
GENERATE_TREEVIEW = YES
|
||||||
|
|
@ -1,37 +0,0 @@
|
||||||
Linux/Mac OS X
|
|
||||||
==============
|
|
||||||
To install doxygen:
|
|
||||||
$sudo apt-get install doxygen
|
|
||||||
|
|
||||||
If the above does not work go to:
|
|
||||||
http://www.stack.nl/~dimitri/doxygen/download.html for the correct download.
|
|
||||||
|
|
||||||
Then go to the following website for inforamtion on the install:
|
|
||||||
http://www.stack.nl/~dimitri/doxygen/install.html
|
|
||||||
|
|
||||||
Then to generate the html, run the following code while you are in this directory:
|
|
||||||
$doxygen Doxyfile
|
|
||||||
|
|
||||||
The html file index.html should be in doc/html unless you changed the output directory.
|
|
||||||
|
|
||||||
The other option for generating the documentation is to use the wizard:
|
|
||||||
$doxywizard &
|
|
||||||
|
|
||||||
doxywizard information:
|
|
||||||
http://www.stack.nl/~dimitri/doxygen/doxywizard_usage.html
|
|
||||||
|
|
||||||
Or go to the Doxygen Manual for information at the website noted below.
|
|
||||||
|
|
||||||
Windows
|
|
||||||
=======
|
|
||||||
Go to the following website for the correct download and follow the wizard to install:
|
|
||||||
http://www.stack.nl/~dimitri/doxygen/download.html
|
|
||||||
|
|
||||||
Run the wizard to generate the documentation.
|
|
||||||
Go to the website below or the Doxygen Manual for information on running doxywizard.
|
|
||||||
http://www.stack.nl/~dimitri/doxygen/doxywizard_usage.html
|
|
||||||
|
|
||||||
Doxygen Manual
|
|
||||||
==============
|
|
||||||
http://www.stack.nl/~dimitri/doxygen/
|
|
||||||
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
||||||
#!/bin/sh
|
|
||||||
rm -rf html
|
|
||||||
doxygen
|
|
||||||
Loading…
Reference in New Issue