1 files changed, 24 insertions, 14 deletions
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 6588f5e552a..4a2d34fd238 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -1,4 +1,4 @@
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.50 2001/06/02 18:25:16 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.51 2001/08/28 14:20:24 petere Exp $ -->
 
 <chapter id="installation">
  <title><![%flattext-install-include[<productname>PostgreSQL</>]]>
@@ -448,19 +448,29 @@ su - postgres
 
      <note>
       <para>
-       To reduce the pollution of shared installation locations (such
-       as <filename>/usr/local/include</filename>), the string
-       <quote><literal>/postgresql</literal></quote> is automatically
-       appended to <varname>datadir</varname>,
-       <varname>sysconfdir</varname>, <varname>includedir</varname>,
-       and <varname>docdir</varname>, unless the fully expanded
-       directory name already contains the string
-       <quote>postgres</quote> or <quote>pgsql</quote>.  For example,
-       if you choose <filename>/usr/local</filename> as prefix, the C
-       header files will be installed in
-       <filename>/usr/local/include/postgresql</filename>, but if the
-       prefix is <filename>/opt/postgres</filename>, then they will be
-       in <filename>/opt/postgres/include</filename>.
+       Care has been taken to make it possible to install PostgreSQL
+       into shared installation locations (such as
+       <filename>/usr/local/include</filename>) without interfering
+       with the namespace of the rest of the system.  First, the
+       string <quote><literal>/postgresql</literal></quote> is
+       automatically appended to <varname>datadir</varname>,
+       <varname>sysconfdir</varname>, and <varname>docdir</varname>,
+       unless the fully expanded directory name already contains the
+       string <quote>postgres</quote> or <quote>pgsql</quote>.  For
+       example, if you choose <filename>/usr/local</filename> as
+       prefix, the documentation will be installed in
+       <filename>/usr/local/doc/postgresql</filename>, but if the
+       prefix is <filename>/opt/postgres</filename>, then it will be
+       in <filename>/opt/postgres/doc</filename>.  Second, the
+       installation layout of the C and C++ header files has been
+       reorganized in the 7.2 release.  The public header files of the
+       client interfaces are installed into
+       <varname>includedir</varname> and are namespace-clean.  The
+       internal header files and the server header files are installed
+       into private directories under
+       <filename><replaceable>includedir</replaceable>/postgresql</filename>.
+       See the <citetitle>Programmer's Guide</citetitle> for
+       information how to get at the header files for each interface.
       </para>
      </note>
     </para>