2012-08-18 05:41:20 +08:00
|
|
|
#####
|
|
|
|
# Build doxygen documentation, if need be.
|
|
|
|
#####
|
2014-05-22 04:13:23 +08:00
|
|
|
IF(ENABLE_DOXYGEN)
|
2014-06-12 05:51:31 +08:00
|
|
|
# The following is redundant but does not hurt anything.
|
2014-03-09 08:39:09 +08:00
|
|
|
|
2014-05-22 04:13:23 +08:00
|
|
|
FILE(GLOB COPY_FILES ${CMAKE_CURRENT_SOURCE_DIR}/*.html ${CMAKE_CURRENT_SOURCE_DIR}/images ${CMAKE_CURRENT_SOURCE_DIR}/*.doc ${CMAKE_CURRENT_SOURCE_DIR}/*.xml ${CMAKE_CURRENT_SOURCE_DIR}/*.m4 ${CMAKE_CURRENT_SOURCE_DIR}/*.texi)
|
|
|
|
FILE(COPY ${COPY_FILES} DESTINATION ${CMAKE_CURRENT_BINARY_DIR}/)
|
2014-06-12 05:51:31 +08:00
|
|
|
|
2014-06-19 03:46:22 +08:00
|
|
|
# Set abs_top_srcdir to work with the autotools
|
2014-05-22 04:13:23 +08:00
|
|
|
# doxyfile template.
|
|
|
|
SET(abs_top_srcdir ${CMAKE_SOURCE_DIR})
|
|
|
|
SET(abs_builddir ${CMAKE_CURRENT_BINARY_DIR})
|
2014-06-19 03:46:22 +08:00
|
|
|
|
2014-05-22 04:13:23 +08:00
|
|
|
# Create general and guide doxyfiles.
|
|
|
|
CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in
|
|
|
|
${CMAKE_CURRENT_BINARY_DIR}/Doxyfile @ONLY)
|
2014-06-12 05:51:31 +08:00
|
|
|
|
2014-09-19 05:05:08 +08:00
|
|
|
# Generate User Documentation
|
|
|
|
ADD_CUSTOM_TARGET(doc_all ALL
|
2014-05-22 04:13:23 +08:00
|
|
|
${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
|
|
|
|
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
|
2014-09-19 05:05:08 +08:00
|
|
|
COMMENT "Generating API Documentation" VERBATIM)
|
2014-03-09 08:39:09 +08:00
|
|
|
|
2014-06-19 04:33:49 +08:00
|
|
|
# If ENABLE_DOXYGEN_LATEX_OUTPUT is true, automatically build
|
|
|
|
# the PDF files.
|
2014-06-21 07:41:09 +08:00
|
|
|
IF(ENABLE_DOXYGEN_PDF_OUTPUT)
|
2014-06-19 04:33:49 +08:00
|
|
|
# Process 'main' netcdf documentation.
|
|
|
|
FIND_PROGRAM(NC_MAKE NAMES make)
|
2014-06-19 05:19:14 +08:00
|
|
|
FIND_PROGRAM(NC_PDFLATEX NAMES pdflatex)
|
|
|
|
IF(NOT NC_MAKE OR NOT NC_PDFLATEX)
|
2014-06-21 07:41:09 +08:00
|
|
|
MESSAGE(WARNING "Unable to locate 'make' and/or 'pdflatex' program. Unable to build pdf documentation.")
|
2014-06-19 04:33:49 +08:00
|
|
|
ELSE()
|
|
|
|
ADD_CUSTOM_TARGET(doc_all_pdf ALL
|
|
|
|
make
|
|
|
|
COMMAND mv refman.pdf ../netcdf.pdf
|
|
|
|
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/latex_main"
|
|
|
|
COMMENT "Building NetCDF PDF Documentation" VERBATIM
|
|
|
|
)
|
|
|
|
|
|
|
|
# Process 'guide' netcdf documentation.
|
|
|
|
ADD_CUSTOM_TARGET(doc_guide_pdf ALL
|
|
|
|
make
|
|
|
|
COMMAND mv refman.pdf ../netcdf-guide.pdf
|
|
|
|
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/latex_guide"
|
|
|
|
COMMENT "Building NetCDF-Guide PDF Documentation" VERBATIM
|
|
|
|
)
|
|
|
|
|
|
|
|
# Process 'tutorial' netcdf documentation.
|
|
|
|
ADD_CUSTOM_TARGET(doc_tutorial_pdf ALL
|
|
|
|
make
|
|
|
|
COMMAND mv refman.pdf ../netcdf-tutorial.pdf
|
|
|
|
WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/latex_tutorial"
|
|
|
|
COMMENT "Building NetCDF-Tutorial PDF Documentation" VERBATIM
|
|
|
|
)
|
2014-06-21 07:41:09 +08:00
|
|
|
INSTALL(FILES "${CMAKE_CURRENT_BINARY_DIR}/netcdf.pdf"
|
|
|
|
"${CMAKE_CURRENT_BINARY_DIR}/netcdf-guide.pdf"
|
|
|
|
"${CMAKE_CURRENT_BINARY_DIR}/netcdf-tutorial.pdf"
|
|
|
|
DESTINATION "${CMAKE_INSTALL_DOCDIR}/pdf"
|
|
|
|
COMPONENT documentation)
|
2014-06-19 05:19:14 +08:00
|
|
|
|
2014-06-19 04:33:49 +08:00
|
|
|
ENDIF()
|
2014-06-21 07:41:09 +08:00
|
|
|
|
2014-06-19 04:33:49 +08:00
|
|
|
ENDIF()
|
|
|
|
|
|
|
|
|
2014-06-12 05:51:31 +08:00
|
|
|
# Copy the image files used by markdown documentation
|
2014-05-22 05:15:56 +08:00
|
|
|
# manually.
|
2014-06-12 05:51:31 +08:00
|
|
|
FILE(GLOB IMG_FILES ${CMAKE_CURRENT_BINARY_DIR}/images/*.jpg
|
2014-05-22 05:15:56 +08:00
|
|
|
${CMAKE_CURRENT_BINARY_DIR}/images/*.png)
|
2014-06-12 05:51:31 +08:00
|
|
|
|
|
|
|
FILE(COPY ${IMG_FILES} DESTINATION ${CMAKE_CURRENT_BINARY_DIR}/html)
|
|
|
|
|
2014-06-21 07:41:09 +08:00
|
|
|
INSTALL(DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/html/"
|
|
|
|
DESTINATION "${CMAKE_INSTALL_DOCDIR}/html"
|
2014-05-22 05:15:56 +08:00
|
|
|
COMPONENT documentation)
|
2014-06-12 05:51:31 +08:00
|
|
|
|
2014-05-22 05:15:56 +08:00
|
|
|
ENDIF(ENABLE_DOXYGEN)
|
2012-08-18 05:41:20 +08:00
|
|
|
|
2014-04-01 06:27:37 +08:00
|
|
|
SET(CUR_EXTRA_DIST ${CUR_EXTRA_DIST} CMakeLists.txt Makefile.am netcdf.m4 DoxygenLayout.xml Doxyfile.in Doxyfile.guide.in footer.html mainpage.dox tutorial.dox install.dox dispatch.dox guide.dox types.dox notes.dox cdl.dox architecture.dox internal.dox install-fortran.dox Doxyfile.in.cmake windows-binaries.md building-with-cmake.md)
|
2013-06-04 00:42:04 +08:00
|
|
|
|
2014-06-12 05:51:31 +08:00
|
|
|
ADD_EXTRA_DIST("${CUR_EXTRA_DIST}")
|