[kde-doc-english] man page docbooks

[Burkhard Lück]

Hi,

in the kde documentation there are two groups of man pages in docbook format:

1) 15 man pages in kdelibs/doc (kross, makekdewidgets, kjs, kdeinit4, 
kdeoptions, kbuildsycoca4, meinproc4 etc...). These docbooks are uptodate  
and properly installed with the kde4_create_manpage macro.

2) 44 application and kdesdk/scripts man pages (kmag, kappfinder, kstars indi 
drivers etc...). These man pages are from 2003 and 2005, a lot of them 
generated from debian man pages.
Most of these docbooks are not properly installed (no man page is generated), 
so they can not be displayed. This is the case afaik since kde 3.3.

Is no 2 intended or just an oversight?

To fix this, all CMakeList.Text files in docdirs with man pages need an 
additional line with a kde4_create_manpage macro call.

And the kde4_create_manpage macro needs this patch to make it possible to 
build the man pages in dirs like kdeedu/doc/kstars or kdesdk/doc/scripts with 
more than one man page:

kdedev at rebutia:~/svn$ svn diff kdelibs/cmake/
Index: kdelibs/cmake/modules/KDE4Macros.cmake
===================================================================
--- kdelibs/cmake/modules/KDE4Macros.cmake      (Revision 894687)
+++ kdelibs/cmake/modules/KDE4Macros.cmake      (Arbeitskopie)
@@ -270,7 +272,7 @@
       DEPENDS ${_input} ${_KDE4_MEINPROC_EXECUTABLE_DEP} ${_ssheet}
    )
    get_filename_component(_targ ${CMAKE_CURRENT_SOURCE_DIR} NAME)
-   set(_targ "${_targ}-manpage")
+   set(_targ "${_targ}-manpage-${_base}")
    add_custom_target(${_targ} ALL DEPENDS "${_outdoc}")

    set(_args ${ARGN})

The worst is yet to come, _ALL_ translations of these man pages have never 
been installed properly building kde from source, what a waste of time and 
work of our translation teams. 

How to proceed?

-- 
Burkhard Lück