[CMake] Question about config_file.

[Petr Kmoch]

Hi Steven.

"what is the configure_file command for?"

https://cmake.org/cmake/help/latest/command/configure_file.html

"what is Doxygen.in?"

Check its contents at wherever you found the example for details, but it
should be a template for the Doxygen configuration file (the config file
read by Doxygen).

Petr

On Sun, 9 Jun 2019 at 00:18, Steven Truppe <workbench at gmx.at> wrote:

> Hi everyone,
>
> currently i'm trying to build my doxygen documentation from my
> CMakeLists.txt file. I found the following example that seems to be
> correct:
>
> ######################
> ## bsBuildDoxygen() ##
> ######################
> macro(bsBuildDocs)
> 	if(GENERATE_DOCS)
> 		# check if Doxygen is installed
> 		find_package(Doxygen)
> 		if(DOXYGEN_FOUND)
> 			# set input and output files
> 			set(DOXYGEN_IN ${CMAKE_CURRENT_SOURCE_DIR}/doc/manual/Doxyfile.in)
> 			set(DOXYGEN_OUT ${CMAKE_CURRENT_SOURCE_DIR}/doc/manual/Doxyfile)
>
> 			# request to configure the file
> 			configure_file(${DOXYGEN_IN} ${DOXYGEN_OUT} @ONLY)
> 			message("Doxygen build started")
>
> 			# note the option ALL which allows to build the docs together with the application
> 			add_custom_target( doc_doxygen ALL
> 				COMMAND ${DOXYGEN_EXECUTABLE} ${DOXYGEN_OUT}
> 				WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
> 				COMMENT "Generating API documentation with Doxygen"
> 				VERBATIM )
> 		else()
> 		  message("Doxygen need to be installed to generate the doxygen documentation")
> 		endif()
> 	endif()
> endmacro()
>
> Now my question is about the configure_file command. what is Doxygen.in
> and what is the configure_file command for ?
>
>
> best regards!
> --
>
> Powered by www.kitware.com
>
> Please keep messages on-topic and check the CMake FAQ at:
> http://www.cmake.org/Wiki/CMake_FAQ
>
> Kitware offers various services to support the CMake community. For more
> information on each offering, please visit:
>
> CMake Support: http://cmake.org/cmake/help/support.html
> CMake Consulting: http://cmake.org/cmake/help/consulting.html
> CMake Training Courses: http://cmake.org/cmake/help/training.html
>
> Visit other Kitware open-source projects at
> http://www.kitware.com/opensource/opensource.html
>
> Follow this link to subscribe/unsubscribe:
> https://cmake.org/mailman/listinfo/cmake
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://cmake.org/pipermail/cmake/attachments/20190610/a9e64f91/attachment.html>