From 7523960d639a4e59af3afc93e32f6460883f6641 Mon Sep 17 00:00:00 2001
From: Andrew Dunstan <andrew@dunslane.net>
Date: Thu, 28 Jan 2010 23:59:52 +0000
Subject: Add new make targets "world", "install-world" and
 "installcheck-world" to build, install and check just about everything. In
 addition to everything built installed and tested by all, install and
 installcheck targets, these build HTML Docs, build and test contrib, and test
 PLs and ECPG.

---
 doc/src/sgml/contrib.sgml      |  6 ++++--
 doc/src/sgml/installation.sgml | 23 +++++++++++++++++++++--
 2 files changed, 25 insertions(+), 4 deletions(-)

(limited to 'doc/src')

diff --git a/doc/src/sgml/contrib.sgml b/doc/src/sgml/contrib.sgml
index 2895e6c170f..3ed2023b1b5 100644
--- a/doc/src/sgml/contrib.sgml
+++ b/doc/src/sgml/contrib.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/contrib.sgml,v 1.15 2009/11/18 21:57:56 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/contrib.sgml,v 1.16 2010/01/28 23:59:52 adunstan Exp $ -->
 
 <appendix id="contrib">
  <title>Additional Supplied Modules</title>
@@ -16,7 +16,9 @@
 
  <para>
   When building from the source distribution, these modules are not built
-  automatically.  You can build and install all of them by running:
+  automatically, unless you build the "world" target 
+  (see <xref linkend="build">).
+  You can build and install all of them by running:
 <screen>
 <userinput>gmake</userinput>
 <userinput>gmake install</userinput>
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 23d120b8a32..003d172b01e 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.339 2010/01/22 22:50:03 momjian Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/installation.sgml,v 1.340 2010/01/28 23:59:52 adunstan Exp $ -->
 
 <chapter id="installation">
  <title><![%standalone-include[<productname>PostgreSQL</>]]>
@@ -1526,7 +1526,7 @@ su - postgres
     </para>
    </step>
 
-  <step>
+  <step id="build">
    <title>Build</title>
 
    <para>
@@ -1539,6 +1539,18 @@ su - postgres
     hardware. The last line displayed should be:
 <screen>
 All of PostgreSQL is successfully made. Ready to install.
+</screen>
+   </para>
+
+  <para>
+   If you want to build everything that can be built, including the HTML
+   documentation and the Additional Modules, type instead:
+<screen>
+<userinput>gmake world</userinput>
+</screen>
+   The last line displayed should be:
+<screen>
+PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
 </screen>
    </para>
   </step>
@@ -1594,6 +1606,13 @@ All of PostgreSQL is successfully made. Ready to install.
     be granted.
    </para>
 
+   <para>
+    If you built the world above, type instead:
+<screen>
+<userinput>gmake install-world</userinput>
+</screen>
+   </para>
+
    <para>
     You can use <literal>gmake install-strip</literal> instead of
     <literal>gmake install</literal> to strip the executable files and
-- 
cgit v1.2.3