bde949f7e4
git-svn-id: https://free-cad.svn.sourceforge.net/svnroot/free-cad/trunk@5270 e8eeb9e2-ec13-0410-a4a9-efa5cf37419d
99 lines
4.4 KiB
CMake
99 lines
4.4 KiB
CMake
find_package(Doxygen)
|
|
if(DOXYGEN_FOUND)
|
|
|
|
IF (DOXYGEN_DOT_EXECUTABLE)
|
|
SET(HAVE_DOT YES)
|
|
ELSE (DOXYGEN_DOT_EXECUTABLE)
|
|
SET(HAVE_DOT NO)
|
|
ENDIF (DOXYGEN_DOT_EXECUTABLE)
|
|
|
|
SET(DOXYGEN_LANGUAGE "English" CACHE STRING "Language used by doxygen")
|
|
MARK_AS_ADVANCED(DOXYGEN_LANGUAGE)
|
|
|
|
# note: this test is obsolete if DevDoc target is used
|
|
if (NOT FREECAD_BUILD_GUI)
|
|
message("Note: Gui is not built. Documentation may lack some parts.")
|
|
endif (NOT FREECAD_BUILD_GUI)
|
|
|
|
# directory order seems important for correct macro expansion
|
|
# (files containing macros definitions must be parsed before the files using them)
|
|
SET(DOXYGEN_SOURCE_DIR ${COIN3D_INCLUDE_DIR}/Inventor/fields/SoSubField.h
|
|
${CMAKE_SOURCE_DIR}/src/CXX
|
|
${CMAKE_SOURCE_DIR}/src/zipios++
|
|
${CMAKE_SOURCE_DIR}/src/3rdParty
|
|
${CMAKE_SOURCE_DIR}/src/Build
|
|
${CMAKE_SOURCE_DIR}/src/Base
|
|
${CMAKE_BINARY_DIR}/src/Base
|
|
${CMAKE_SOURCE_DIR}/src/App
|
|
${CMAKE_BINARY_DIR}/src/App
|
|
${CMAKE_SOURCE_DIR}/src/Gui
|
|
${CMAKE_BINARY_DIR}/src/Gui
|
|
${CMAKE_SOURCE_DIR}/src/Mod
|
|
${CMAKE_BINARY_DIR}/src/Mod
|
|
${CMAKE_SOURCE_DIR}/src/Main
|
|
${CMAKE_SOURCE_DIR}/src/Doc
|
|
)
|
|
STRING(REGEX REPLACE ";" " " DOXYGEN_INPUT_LIST "${DOXYGEN_SOURCE_DIR}")
|
|
|
|
# exclude some subdirectories
|
|
# src/Tools : content not relevant ?
|
|
# src/3rdParty/CxImage : obsolete utility
|
|
# src/3rdParty/Pivy
|
|
# src/3rdParty/Pivy-0.5 : huge python wrappers around Coin3D, not focused
|
|
# on FreeCAD properly
|
|
set( DOXYGEN_EXCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/Tools)
|
|
list(APPEND DOXYGEN_EXCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/3rdParty/CxImage)
|
|
list(APPEND DOXYGEN_EXCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/3rdParty/Pivy)
|
|
list(APPEND DOXYGEN_EXCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/3rdParty/Pivy-0.5)
|
|
list(APPEND DOXYGEN_EXCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/3rdParty/salomesmesh)
|
|
|
|
STRING(REGEX REPLACE ";" " " DOXYGEN_EXCLUDE_LIST "${DOXYGEN_EXCLUDE_DIR}")
|
|
|
|
SET(DOXYGEN_OUTPUT_DIR ${CMAKE_BINARY_DIR}/Doc/SourceDocu)
|
|
SET(DOXYGEN_IMAGE_PATH ${CMAKE_SOURCE_DIR}/src/Gui/Icons)
|
|
SET(DOXYGEN_LAYOUT_FILE ${CMAKE_SOURCE_DIR}/src/Doc/FreecadDoxygenLayout.xml)
|
|
|
|
find_package(Coin3DDoc)
|
|
if( COIN3D_DOC_FOUND )
|
|
SET(DOXYGEN_TAGFILES
|
|
${COIN3D_DOC_TAGFILE}=${COIN3D_DOC_PATH}
|
|
)
|
|
endif( COIN3D_DOC_FOUND )
|
|
|
|
configure_file(${CMAKE_CURRENT_SOURCE_DIR}/BuildDevDoc.cfg.in
|
|
${CMAKE_CURRENT_BINARY_DIR}/BuildDevDoc.cfg @ONLY)
|
|
|
|
if( FREECAD_MAINTAINERS_BUILD )
|
|
ADD_CUSTOM_TARGET(SourceDocu
|
|
${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/BuildDevDoc.cfg
|
|
COMMAND ${QT_HELPCOMPILER_EXECUTABLE} "\"${CMAKE_BINARY_DIR}/Doc/SourceDocu/html/index.qhp\""
|
|
COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_BINARY_DIR}/Doc/SourceDocu/html/index.qch ${CMAKE_BINARY_DIR}/Doc/FreeCADSource.qch
|
|
WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
|
|
DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/BuildDevDoc.cfg
|
|
)
|
|
|
|
ADD_CUSTOM_TARGET(UserDocu
|
|
${PYTHON_EXECUTABLE}
|
|
${CMAKE_SOURCE_DIR}/src/Tools/wiki2qhelp.py
|
|
-c ${QT_HELPCOMPILER_EXECUTABLE}
|
|
-g ${QT_COLLECTIOMGENERATOR_EXECUTABLE}
|
|
-o ${CMAKE_BINARY_DIR}/Doc
|
|
)
|
|
|
|
else( FREECAD_MAINTAINERS_BUILD )
|
|
|
|
# reconfigure to have all sources files generated from xml, whatever build options were
|
|
# generate source documentation
|
|
# delete CMakeCache to reset to default build options next time
|
|
ADD_CUSTOM_TARGET(DevDoc
|
|
${CMAKE_COMMAND} -D FREECAD_BUILD_GUI:BOOL=ON -D FREECAD_BUILD_FEM:BOOL=ON ${CMAKE_SOURCE_DIR}
|
|
COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/BuildDevDoc.cfg
|
|
COMMAND ${CMAKE_COMMAND} -E remove ${CMAKE_BINARY_DIR}/CMakeCache.txt
|
|
WORKING_DIRECTORY ${CMAKE_BINARY_DIR}
|
|
)
|
|
|
|
endif( FREECAD_MAINTAINERS_BUILD )
|
|
|
|
endif( DOXYGEN_FOUND )
|
|
|