Add some verbiage about "make dist".

git-svn-id: svn://svn.valgrind.org/valgrind/trunk@12170

diff --git a/README_DEVELOPERS b/README_DEVELOPERS
index 9d523db5653a82d9f6924f4f5834a18beb8d5098..b4b7d4ffa2d3df42cf13b97fc98f369e6fafe4b2 100644 (file)
--- a/README_DEVELOPERS
+++ b/README_DEVELOPERS
@@ -17,6 +17,23 @@ output spewed out during compilation, letting you actually see any errors,
 warnings, etc.
 
 
+Building a distribution tarball
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+To build a distribution tarball from the valgrind sources:
+
+  make dist
+
+In addition to compiling, linking and packaging everything up, the command
+will also build the documentation. Even if all required tools for building the
+documentation are installed, this step may not succeed because of hidden
+dependencies. E.g. on Ubuntu you must have "docbook-xsl" installed.
+Additionally, specific tool versions maybe needed.
+
+If you only want to test whether the generated tarball is complete and runs
+regression tests successfully, building documentation is not needed.
+Edit docs/Makefile.am, search for BUILD_ALL_DOCS and follow instructions there.
+
+
 Running the regression tests
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 To build and run all the regression tests, run "make [--quiet] regtest".