packaging(RHEL-CTDB): add a comment, why we need precompiled manpages as fallback

Particularly the version of the docbook XSL style sheets shipped with
RHEL5 have are missing some definitions needed for building the manpages.

diff --git a/packaging/RHEL-CTDB/samba.spec.tmpl b/packaging/RHEL-CTDB/samba.spec.tmpl
index 6abdb6b3874c326c2ec6881c313389d457a8acd4..9e470e81aa9fe19f773a19a8c7c2d4548eb19250 100644 (file)
--- a/packaging/RHEL-CTDB/samba.spec.tmpl
+++ b/packaging/RHEL-CTDB/samba.spec.tmpl
@@ -279,8 +279,19 @@ do
        fi
 done
 
-# try and build the manpages
 cd ..
+
+# try and build the manpages
+#
+# NOTE: some (older) versions the docbook XSL style sheets
+# are missing some definitions that are required for building
+# the manual pages (e.g. list-indent).
+#
+# This applies in particular to the version 1.69 of
+# docbook-style-xsl that is shipped with RHEL 5.
+# We therefore use checked in precompiled manpages
+# if the docs build fails.
+#
 ./release-scripts/build-manpages-nogit || tar xjf packaging/RHEL-CTDB/manpages.tar.bz2
 
 # Remove some permission bits to avoid to many dependencies