Switching to Asciidoctor for man page generation

Author: gershnik

CHANGELOG.md

@@ -9,6 +9,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - Terminal output is now in color when supported by the terminal. Because it is 2026.
   `NO_COLOR` and `FORCE_COLOR` environment variables are fully supported too.
 - Command line help now wraps correctly at the terminal edge
+- Manpage is now generated using Asciidoctor.
 - Updated 3rd party dependencies
 
 ### Fixed

CMakeLists.txt

@@ -279,26 +279,25 @@ add_custom_command(
     VERBATIM
 )
 
-if (PANDOC_PATH)
+if (ASCIIDOCTOR_PATH)
 
     add_custom_command(
         OUTPUT ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8
-        MAIN_DEPENDENCY ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8.md
-        COMMAND ${PANDOC_PATH} --standalone --to man ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8.md -o ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8
+        MAIN_DEPENDENCY ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8.adoc
+        COMMAND ${ASCIIDOCTOR_PATH} -b manpage ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8.adoc -o ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8
         VERBATIM
     )
 
-endif()
-
-if (GROFF_PATH)
     add_custom_command(
         OUTPUT ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8.html
-        MAIN_DEPENDENCY ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8
-        COMMAND cat ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8 | ${GROFF_PATH} -mandoc -Thtml > ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8.html
+        MAIN_DEPENDENCY ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8.adoc
+        COMMAND ${ASCIIDOCTOR_PATH} -a doctype=article ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8.adoc -o ${CMAKE_CURRENT_SOURCE_DIR}/doc/wsddn.8.html
         VERBATIM
     )
+
 endif()
 
+
 if (${CMAKE_SYSTEM_NAME} STREQUAL "Darwin" AND NOT WSDDN_MACOS_SUPPRESS_WRAPPER)
 
     add_subdirectory(installers/mac/wrapper wrapper)

README.md

@@ -523,7 +523,7 @@ Log file is located at `/var/log/wsddn.log`. Log file rotation is configured via
 
 ### FreeBSD
 
-Pre-built packages are available for FreeBSD 13, 14 and 15 in a custom binary package repository. 
+Pre-built packages are available for FreeBSD 14 and 15 in a custom binary package repository. 
 Both `amd64` (aka `x86_64`) and `arm64` (aka `aarch64`) architectures are supported.
 
 <details>

cmake/detect_system.cmake

@@ -193,5 +193,4 @@ if (WSDDN_WITH_SYSTEMD STREQUAL "yes" OR WSDDN_WITH_SYSTEMD STREQUAL "auto" AND
 endif()
 
 
-find_program(PANDOC_PATH pandoc)
-find_program(GROFF_PATH groff)
+find_program(ASCIIDOCTOR_PATH asciidoctor)