Update, polish, consistencify preface/intro sections.

1 files changed, 21 insertions, 31 deletions

diff --git a/doc/src/sgml/programmer.sgml b/doc/src/sgml/programmer.sgml
index f326af433e7..81bbf426539 100644
--- a/doc/src/sgml/programmer.sgml
+++ b/doc/src/sgml/programmer.sgml
@@ -1,51 +1,41 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/Attic/programmer.sgml,v 1.32 2001/01/24 19:42:46 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/Attic/programmer.sgml,v 1.33 2001/02/03 19:03:27 petere Exp $
 
 PostgreSQL Programmer's Guide.
 -->
 
 <book id="programmer">
 
- <title><![%single-book;[PostgreSQL &version;]]> Programmer's Guide</title>
+ <title>PostgreSQL &version; Programmer's Guide</title>
  <bookinfo>
   <corpauthor>The PostgreSQL Global Development Group</corpauthor>
+  &legal;
+ </bookinfo>
 
-  <editor>
-   <firstname>Thomas</firstname>
-   <surname>Lockhart</surname>
-   <affiliation>
-    <orgname>Caltech/JPL</orgname>
-   </affiliation>
-  </editor>
-
-  <legalnotice>
-   <para>
-    <productname>PostgreSQL</productname> is Copyright &copy; 1996-2001
-    by PostgreSQL Global Development Group
-   </para>
-  </legalnotice>
+<![%single-book[
+  &intro;
+]]>
 
- </bookinfo>
+ <preface id="organization">
+  <title>Organization</title>
 
- <preface id="pg-preface">
-  <title>Summary</title>
+  <para>
+   The first part of this manual is the description of the client-side
+   programming interfaces and support libraries for various languages.
+   The second part explains the <productname>PostgreSQL</productname>
+   approach to extensibility and describe how users can extend
+   <productname>PostgreSQL</productname> by adding user-defined types,
+   operators, aggregates, and both query language and programming
+   language functions.  After a discussion of the
+   <productname>PostgreSQL</productname> rule system, we discuss the
+   trigger and SPI interfaces.
+  </para>
 
   <para>
-   <productname>Postgres</productname>, 
-   developed originally in the UC Berkeley Computer Science Department,
-   pioneered many of the object-relational concepts
-   now becoming available in some commercial databases.
-   It provides SQL92/SQL99 language support,
-   transaction integrity, and type extensibility.
-   <productname>PostgreSQL</productname> is an 
-   open-source descendant of this original Berkeley code.
+   Proficiency with Unix and C programming is assumed.
   </para>
  </preface>
 
-<![%single-book[
-  &intro-pg;
-]]>
-
  <part id="programmer-client">
   <title>Client Interfaces</title>
   &libpq;