summaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorTom Lane2001-02-10 02:31:31 +0000
committerTom Lane2001-02-10 02:31:31 +0000
commitd08741eab55f44214d08f33177523ec4821de532 (patch)
tree192af3b22d30b8be1ec3256ebf4806e601234612 /doc/src
parentcf21985ab59e0075704b0322f7ba84033bf7e16e (diff)
Restructure the key include files per recent pghackers discussion: there
are now separate files "postgres.h" and "postgres_fe.h", which are meant to be the primary include files for backend .c files and frontend .c files respectively. By default, only include files meant for frontend use are installed into the installation include directory. There is a new make target 'make install-all-headers' that adds the whole content of the src/include tree to the installed fileset, for use by people who want to develop server-side code without keeping the complete source tree on hand. Cleaned up a whole lot of crufty and inconsistent header inclusions.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/installation.sgml19
1 files changed, 17 insertions, 2 deletions
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index a8a5f196c3c..11d3cb20d5f 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.34 2001/01/15 21:17:27 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.35 2001/02/10 02:31:26 tgl Exp $ -->
<chapter id="installation">
<title><![%flattext-install-include[<productname>PostgreSQL</>]]> Installation Instructions</title>
@@ -783,11 +783,26 @@ All of PostgreSQL is successfully made. Ready to install.
them, but how to do that is left as an exercise.
</para>
+ <para>
+ The standard install installs only the header files needed for client
+ application development. If you plan to do any server-side program
+ development (such as custom functions or datatypes written in C),
+ then you may want to install the entire <productname>PostgreSQL</>
+ include tree into your target include directory. To do that, enter
+<screen>
+<userinput>gmake install-all-headers</userinput>
+</screen>
+ This adds a megabyte or two to the install footprint, and is only
+ useful if you don't plan to keep the whole source tree around for
+ reference. (If you do, you can just use the source's include
+ directory when building server-side software.)
+ </para>
+
<formalpara>
<title>Client-only installation</title>
<para>
If you want to install only the client applications and
- interfaces, then you can use these commands:
+ interface libraries, then you can use these commands:
<screen>
<userinput>gmake -C src/bin install</>
<userinput>gmake -C src/interfaces install</>