Update, polish, consistencify preface/intro sections.

Author: petere

doc/src/sgml/Makefile

@@ -8,7 +8,7 @@
 #
 #
 # IDENTIFICATION
-#    $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.28 2001/01/06 16:54:16 petere Exp $
+#    $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.29 2001/02/03 19:03:26 petere Exp $
 #
 #----------------------------------------------------------------------------
 
@@ -85,7 +85,7 @@ man: $(ALLSGML)
 ## HTML
 ##
 
-JADE.html = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -d $(HDSL) -V %use-id-as-filename% -t sgml
+JADE.html = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -d $(HDSL) -V %use-id-as-filename% -V %generate-legalnotice-link% -t sgml
 
 postgres.html: postgres.sgml $(ALLSGML)
 	@rm -f *.htm

doc/src/sgml/about.sgml

@@ -1,55 +1,27 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.31 2001/01/24 23:15:19 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.32 2001/02/03 19:03:26 petere Exp $
 -->
 
 <book id="admin">
 
 <!-- Title information -->
 
- <title><![%single-book;[PostgreSQL &version;]]> Administrator's Guide</title>
+ <title>PostgreSQL &version; Administrator's Guide</title>
+
  <bookinfo>
   <corpauthor>The PostgreSQL Global Development Group</corpauthor>
-
-  <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>
-
+  &legal;
  </bookinfo>
 
- <preface id="ag-preface">
-  <title>Summary</title>
-
-  <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.
-  </para>
- </preface>
-
 <!--
   Disable these extra intro chapters since some elements (e.g. y2k
   statement) are included in the first intro.sgml and cause errors if
   included twice.
 -->
 <![%single-book;[
-  &intro-ag;
+  &intro;
 ]]>
+
   &installation;
   &installw;
   &runtime;
@@ -62,6 +34,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.31 2001/01/24 23:15:19
   &recovery;
   &regress;
   &release;
+
 <![%single-book;[
   &biblio;
 ]]>

doc/src/sgml/admin.sgml

@@ -1,18 +1,19 @@
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/Attic/developer.sgml,v 1.3 2000/11/29 20:15:59 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/Attic/developer.sgml,v 1.4 2001/02/03 19:03:26 petere Exp $ -->
 <!-- PostgreSQL Developer's Guide -->
 
 <book id="developer">
- <title><![%single-book;[PostgreSQL &version;]]> Developer's Guide</title>
+ <title>PostgreSQL &version; Developer's Guide</title>
 
  <bookinfo>
+  <corpauthor>The PostgreSQL Global Development Group</corpauthor>
+  &legal;
+
   <abstract>
    <simpara>
     This document contains assorted information that can be of use to
     <productname>PostgreSQL</> developers.
    </simpara>
   </abstract>
-
-  <corpauthor>The PostgreSQL Global Development Group</corpauthor>
  </bookinfo>
 
  &sources;

doc/src/sgml/developer.sgml

@@ -1,6 +1,5 @@
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/filelist.sgml,v 1.6 2001/01/24 23:15:19 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/filelist.sgml,v 1.7 2001/02/03 19:03:26 petere Exp $ -->
 
-<!entity about      SYSTEM "about.sgml">
 <!entity history    SYSTEM "history.sgml">
 <!entity info       SYSTEM "info.sgml">
 <!entity legal      SYSTEM "legal.sgml">
@@ -45,7 +44,6 @@
 <!entity backup        SYSTEM "backup.sgml">
 <!entity charset       SYSTEM "charset.sgml">
 <!entity client-auth   SYSTEM "client-auth.sgml">
-<!entity intro-ag      SYSTEM "intro-ag.sgml">
 <!entity installation  SYSTEM "installation.sgml">
 <!entity installw      SYSTEM "install-win32.sgml">
 <!entity manage-ag     SYSTEM "manage-ag.sgml">
@@ -63,7 +61,6 @@
 <!entity extend     SYSTEM "extend.sgml">
 <!entity func-ref   SYSTEM "func-ref.sgml">
 <!entity gist       SYSTEM "gist.sgml">
-<!entity intro-pg   SYSTEM "intro-pg.sgml">
 <!entity indexcost  SYSTEM "indexcost.sgml">
 <!entity jdbc       SYSTEM "jdbc.sgml">
 <!entity libpgeasy  SYSTEM "libpgeasy.sgml">

doc/src/sgml/filelist.sgml

@@ -1,22 +1,22 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/history.sgml,v 1.12 2000/12/22 21:51:57 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/history.sgml,v 1.13 2001/02/03 19:03:26 petere Exp $
 -->
 
 <sect1 id="history">
  <title>A Short History of <productname>Postgres</productname></title>
 
  <para>
-  The Object-Relational Database Management System now known as 
+  The object-relational database management system now known as 
   <productname>PostgreSQL</productname> (and briefly called
   <productname>Postgres95</productname>) is derived from the
-  <productname>Postgres</productname> package written at Berkeley.
-  With over a decade of
+  <productname>Postgres</productname> package written at the University of
+  California at Berkeley.  With over a decade of
   development behind it, <productname>PostgreSQL</productname> 
   is the most advanced open-source database available anywhere,
   offering multi-version concurrency control, supporting almost
   all SQL constructs (including subselects, transactions, and
   user-defined types and functions), and having a wide range of
-  language bindings available (including C, C++, Java, perl, tcl, and python).
+  language bindings available (including C, C++, Java, Perl, Tcl, and Python).
  </para>
 
  <sect2>