Index: trunk/psconfig/INSTALL
===================================================================
--- trunk/psconfig/INSTALL	(revision 29555)
+++ trunk/psconfig/INSTALL	(revision 41706)
@@ -1,2 +1,9 @@
+
+*** See Summary at the bottom of this file ***
+
+The directory 'ipp/psconfig' contains tools for building the IPP, for
+testing the build environment, for building external C libraries and
+Perl modules, for setting up the user's environment, and for building
+a tarball to be distributed to the end users.
 
 The psconfig system allows the user to build and install the IPP
@@ -6,4 +13,16 @@
 With the psconfig tools, it is easy to switch between different
 installed versions or to recompile subsets of the IPP tree.
+
+Developer Build vs User Build
+
+Within the IPP code base, there are a few modules which are not
+distributed as part of the tarball.  These include 'glueforge', which
+is used to generate code for interacting with the database;
+'dbconfig', which defines a database layout; and 'ippdb.src', which is
+the raw auto-generated code.  The tarball is instead packaged with a
+version of ippdb for which autogen has been run, and for which there
+is a valid 'configure' script.  As a developer, it is necessary to
+build these packages.  There is a '-dev' option for psbuild which
+builds these packages.
 
 1. Set up the psconfig system.
@@ -192,2 +211,12 @@
 ** the steps above are probably not actually needed.  When is PSCONFDIR needed?
 
+*** SUMMARY ***
+
+For Ubuntu:
+
+  psbuild -extbuild -clean -rebuild -dev -optimize -no-as-needed ipp-3.3
+
+For Gentoo:
+
+  psbuild -extbuild -clean -rebuild -dev -optimize ipp-3.1
+