Drop obsolete documentation

Author: ktf

.cmake-format.py

@@ -66,12 +66,6 @@
             "HEADERS": '*',
         }
     },
-    "o2_target_man_page": {
-        "kwargs": {
-            "NAME": '+',
-            "SECTION": '*',
-        }
-    },
     "add_root_dictionary": {
         "kwargs": {
             "LINKDEF": '+',

Algorithm/CMakeLists.txt

@@ -11,9 +11,6 @@
 
 o2_add_header_only_library(Algorithm INTERFACE_LINK_LIBRARIES O2::Headers)
 
-o2_target_man_page(Algorithm NAME Algorithm SECTION 3)
-o2_target_man_page(Algorithm NAME algorithm_parser SECTION 3)
-
 o2_add_test(o2formatparser
             SOURCES test/o2formatparser.cxx
             COMPONENT_NAME Algorithm

Algorithm/doc/Algorithm.3.in

@@ -86,7 +86,6 @@ include(O2AddTestRootMacro)
 include(O2ReportNonTestedMacros)
 include(O2TargetRootDictionary)
 include(O2DataFile)
-include(O2TargetManPage)
 include(O2AddWorkflow)
 include(O2SetROOTPCMDependencies)
 include(O2AddHipifiedExecutable)
@@ -117,10 +116,6 @@ endif()
 
 add_subdirectory(config)
 
-add_custom_target(man ALL)
-o2_target_man_page(man NAME o2)
-o2_target_man_page(man NAME FairMQDevice)
-
 # Testing and packaging only needed if we are the top level directory
 if(CMAKE_SOURCE_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR)
   # Documentation

Algorithm/doc/algorithm_parser.3.in

@@ -12,5 +12,3 @@
 o2_add_executable(ex5
                   SOURCES src/run.cxx
                   COMPONENT_NAME example TARGETVARNAME targetName)
-
-o2_target_man_page(${targetName} NAME ex5 SECTION 7)

CMakeLists.txt

@@ -349,24 +349,6 @@ Note as well that some (very few) tests are ran only for some configurations
 ctest -C RelWithDebInfo
 ```
 
-#### [Ex5](../Examples/Ex5) Adding a man page
-
-If a module provides one or more executables, it might be of interest for the users of those executables to have access to a man page for them. Ex5 illustates that use case.
-
-    .
-    ├── CMakeLists.txt
-    ├── README.md
-    ├── doc
-    │   └── ex5.7.in
-    └── src
-        └── run.cxx
-
-The [man page](ManPages.md) is created using :
-
-    o2_target_man_page([targetName] NAME ex5 SECTION 7)
-
-where `NAME xx` refers to a file `doc/xx.[SECTION].in`, and the actual `targetName` can be found from the base target name (ex5 in that case) using the [o2_name_target](../cmake/O2NameTarget.cmake) function.
-
 ## CTest
 
 In the build directory of O2, if you launch the `ctest` command, all the O2 tests will be ran, which is not always what you want/need, in particular during development.