83 lines
3 KiB
CMake
83 lines
3 KiB
CMake
# Use pod2man to generate manual pages from .pod files
|
|
|
|
# Usage: pod2man(<podfile> <release-string> <man-section> <heading-center-text>)
|
|
#
|
|
# E.g.: pod2man("/path/to/file/mypod.pod" "1.2.3" 1 "My Manual Pages")
|
|
|
|
include(GNUInstallDirs)
|
|
|
|
find_program(POD2MAN pod2man)
|
|
if(NOT POD2MAN)
|
|
message(STATUS "Could not find pod2man - man pages disabled")
|
|
endif()
|
|
|
|
find_program(GZIP gzip)
|
|
if(NOT GZIP)
|
|
message(STATUS "Could not find gzip - man pages uncompressed")
|
|
endif()
|
|
|
|
macro(pod2man PODFILE_FULL RELEASE SECTION CENTER)
|
|
get_filename_component(PODFILE ${PODFILE_FULL} NAME)
|
|
string(REPLACE "." ";" PODFILE_LIST ${PODFILE})
|
|
list(GET PODFILE_LIST 0 NAME)
|
|
list(GET PODFILE_LIST 1 LANG)
|
|
string(TOUPPER ${NAME} NAME_UPCASE)
|
|
if(${LANG} STREQUAL "pod")
|
|
set(LANG "")
|
|
endif()
|
|
|
|
if(NOT EXISTS ${PODFILE_FULL})
|
|
message(FATAL_ERROR "Could not find pod file ${PODFILE_FULL} to generate man page")
|
|
endif(NOT EXISTS ${PODFILE_FULL})
|
|
|
|
if(POD2MAN)
|
|
if(LANG)
|
|
set(MANPAGE_TARGET "man-${NAME}-${LANG}")
|
|
set(MANFILE_TEMP "${CMAKE_CURRENT_BINARY_DIR}/${NAME}.${LANG}.tmp")
|
|
set(MANFILE_FULL "${CMAKE_CURRENT_BINARY_DIR}/${NAME}.${LANG}.${SECTION}")
|
|
set(MANFILE_FULL_GZ "${CMAKE_CURRENT_BINARY_DIR}/${NAME}.${LANG}.${SECTION}.gz")
|
|
set(MANFILE_DEST "${CMAKE_INSTALL_MANDIR}/${LANG}/man${SECTION}")
|
|
else()
|
|
set(MANPAGE_TARGET "man-${NAME}")
|
|
set(MANFILE_TEMP "${CMAKE_CURRENT_BINARY_DIR}/${NAME}.tmp")
|
|
set(MANFILE_FULL "${CMAKE_CURRENT_BINARY_DIR}/${NAME}.${SECTION}")
|
|
set(MANFILE_FULL_GZ "${CMAKE_CURRENT_BINARY_DIR}/${NAME}.${SECTION}.gz")
|
|
set(MANFILE_DEST "${CMAKE_INSTALL_MANDIR}/man${SECTION}")
|
|
endif()
|
|
add_custom_command(
|
|
OUTPUT ${MANFILE_TEMP}
|
|
COMMAND ${POD2MAN} --utf8 --section="${SECTION}" --center="${CENTER}"
|
|
--release="${RELEASE}" --name="${NAME_UPCASE}" "${PODFILE_FULL}" "${MANFILE_TEMP}"
|
|
)
|
|
|
|
add_custom_command(
|
|
OUTPUT ${MANFILE_FULL}
|
|
COMMAND ${CMAKE_CURRENT_SOURCE_DIR}/fix-roff-punct "${MANFILE_TEMP}" > ${MANFILE_FULL}
|
|
DEPENDS ${MANFILE_TEMP}
|
|
)
|
|
if(GZIP AND WITH_MANPAGE_COMPRESSION)
|
|
add_custom_command(
|
|
OUTPUT ${MANFILE_FULL_GZ}
|
|
COMMAND ${GZIP} -f -k --best -n "${MANFILE_FULL}"
|
|
DEPENDS ${MANFILE_FULL}
|
|
)
|
|
add_custom_target(${MANPAGE_TARGET} ALL
|
|
DEPENDS ${MANFILE_FULL_GZ}
|
|
)
|
|
install(
|
|
FILES ${MANFILE_FULL_GZ}
|
|
RENAME ${NAME}.${SECTION}.gz
|
|
DESTINATION ${MANFILE_DEST}
|
|
)
|
|
else()
|
|
add_custom_target(${MANPAGE_TARGET} ALL
|
|
DEPENDS ${MANFILE_FULL}
|
|
)
|
|
install(
|
|
FILES ${MANFILE_FULL}
|
|
RENAME ${NAME}.${SECTION}
|
|
DESTINATION ${MANFILE_DEST}
|
|
)
|
|
endif()
|
|
endif()
|
|
endmacro(pod2man PODFILE NAME SECTION CENTER)
|