packaging(RHEL-CTDB): update the build instructions in the README.

Michael
(This used to be commit f7706c6437d6500a477cb704cb916f16fdfa1395)

1 files changed, 21 insertions, 3 deletions

diff --git a/packaging/RHEL-CTDB/README b/packaging/RHEL-CTDB/README
index 2fff78f0156..f7ce381a927 100644
--- a/packaging/RHEL-CTDB/README
+++ b/packaging/RHEL-CTDB/README
@@ -1,3 +1,21 @@
-In order to keep the docs out of the bzr tree, first get a release 
-tarball of samba, then invoke makerpms.sh with the DOCS_TARBALL variable
-pointing to the docs.tar.bz2 from a Samba release.
+The rpms should be built not directly from the spec file (although
+it is possible) but more conveniently using the makerpms.sh script:
+It takes care of making a source tarball and building the rpms for
+x86_64 and i386, the latter also producing the winbind-32bit
+compatibility packages for x86_64.
+
+The makerpms.sh script must be invoked from out of a git checkout
+(since git archive is used to produce the tarball for rpmbuild).
+
+To eliminate the need of building the docs from the sources
+(which is time consuming and has vast build dependencies),
+you need a samba release docs tarball called docs.tar.bz2 and point
+the DOCS_TARBALL environment variable to it before calling makerpms.sh.
+Alternatively, if the DOCS_TARBALL variable is not set, but if a
+docs.tar.bz2 exists inside the rpm SOURCES directory
+(/usr/src/redhat/SORUCES/ by default), that will be used.
+
+To produce an appropriate docs tarball, you can for instance pack the
+docs dir from a samba release tarball using the command
+"tar cjf docs.tar.bz2 docs".
+Note: The docs tarball needs the docs/ prefix.