Skip to content

Commit

Permalink
Disable latex and class hierarchy generation (#1447)
Browse files Browse the repository at this point in the history
We don't use the latex output anywhere, but it brings in a big
dependency when building documentation or deb packages.
The class hierarchy is also not that useful since there is not much
inheritance used in the codebase. This also brings the doxygen
parameters of sdformat closer to other Gazebo libraries.

(cherry picked from commit 8e7b267)

Signed-off-by: Addisu Z. Taddese <[email protected]>
Co-authored-by: Addisu Z. Taddese <[email protected]>
  • Loading branch information
mergify[bot] and azeey authored Jul 2, 2024
1 parent 4053695 commit 6814763
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 6 deletions.
3 changes: 0 additions & 3 deletions doc/CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,6 @@ if (DOXYGEN_FOUND)
${CMAKE_BINARY_DIR}/doxygen/html
COMMAND cp ${CMAKE_SOURCE_DIR}/doc/search.js
${CMAKE_BINARY_DIR}/doxygen/html/search
COMMAND make -C ${CMAKE_BINARY_DIR}/doxygen/latex
COMMAND mv ${CMAKE_BINARY_DIR}/doxygen/latex/refman.pdf
${CMAKE_BINARY_DIR}/doxygen/latex/sdf-${SDF_VERSION_FULL}.pdf

COMMENT "Generating API documentation with Doxygen" VERBATIM)
endif()
6 changes: 3 additions & 3 deletions doc/sdf.in
Original file line number Diff line number Diff line change
Expand Up @@ -1234,7 +1234,7 @@ SERVER_BASED_SEARCH = NO
# 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
Expand Down Expand Up @@ -1595,7 +1595,7 @@ PERL_PATH = /usr/bin/perl
# this option also works with HAVE_DOT disabled, but it is recommended to
# install and use dot, since it yields more powerful graphs.

CLASS_DIAGRAMS = YES
CLASS_DIAGRAMS = NO

# You can define message sequence charts within doxygen comments using the \msc
# command. Doxygen will then run the mscgen tool (see
Expand All @@ -1617,7 +1617,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 = YES
HAVE_DOT = NO

# The DOT_NUM_THREADS specifies the number of dot invocations doxygen is
# allowed to run in parallel. When set to 0 (the default) doxygen will
Expand Down

0 comments on commit 6814763

Please sign in to comment.