Packaging and distributing documentation with CPack

Packaging documentation is no different than packaging software and its artifacts—documentation is an artifact of a project, after all. Thus, we will use the techniques we learned in Chapter 4, Packaging, Deploying, and Installing a CMake Project, to package our documentation.

Note

If you have not yet read Chapter 4, Packaging, Deploying, and Installing a CMake Project, it is strongly recommended to do so before reading this section.

To illustrate this section, we will return to Chapter 6 - Example 01. We will make the documentation we have generated in this example installable and packageable. Let’s dive back into the CMakeLists.txt file located in the chapter06/ex01_doxdocgen/ folder. With the following code, we will make the html and man documentation installable:

include(GNUInstallDirs)
install(DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/docs/html/"
  DESTINATION "${CMAKE_INSTALL_DOCDIR...