From 478e5beef18aa9a1f26600159bec2451dc50e2a8 Mon Sep 17 00:00:00 2001
From: "Thomas G. Lockhart" <lockhart@fourpalms.org>
Date: Sat, 13 Feb 1999 03:52:46 +0000
Subject: [PATCH] Include chapter on SQL language elements (keywords, etc).
 Should merge with or complement Stefan's Master's Thesis intro to SQL.

---
 doc/src/sgml/postgres.sgml | 352 +++++++++++++++++++------------------
 1 file changed, 179 insertions(+), 173 deletions(-)

diff --git a/doc/src/sgml/postgres.sgml b/doc/src/sgml/postgres.sgml
index c4d7127f952..867b1ee3c00 100644
--- a/doc/src/sgml/postgres.sgml
+++ b/doc/src/sgml/postgres.sgml
@@ -1,11 +1,15 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.17 1999/01/19 16:06:25 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.18 1999/02/13 03:52:46 thomas Exp $
 
 Postgres integrated documentation.
 Other subset docs should be copied and shrunk from here.
 thomas 1998-02-23
 
 $Log: postgres.sgml,v $
+Revision 1.18  1999/02/13 03:52:46  thomas
+Include chapter on SQL language elements (keywords, etc).
+Should merge with or complement Stefan's Master's Thesis intro to SQL.
+
 Revision 1.17  1999/01/19 16:06:25  thomas
 Merge current.sgml into release.sgml so all release notes are in the same
  file. Per Bruce's preference. Go to it Bruce!
@@ -65,19 +69,20 @@ Move SQL reference pages up into the User's Guide.
 
 <!-- user's guide -->
 <!entity advanced SYSTEM "advanced.sgml">
-<!entity environ  SYSTEM "environ.sgml">
-<!entity manage   SYSTEM "manage.sgml">
+<!entity array    SYSTEM "array.sgml">
 <!entity datatype SYSTEM "datatype.sgml">
-<!entity oper     SYSTEM "oper.sgml">
+<!entity environ  SYSTEM "environ.sgml">
 <!entity func     SYSTEM "func.sgml">
-<!entity typeconv SYSTEM "typeconv.sgml">
-<!entity keys     SYSTEM "keys.sgml">
-<!entity array    SYSTEM "array.sgml">
 <!entity inherit  SYSTEM "inherit.sgml">
+<!entity keys     SYSTEM "keys.sgml">
+<!entity manage   SYSTEM "manage.sgml">
+<!entity oper     SYSTEM "oper.sgml">
+<!entity pgaccess SYSTEM "pgaccess.sgml">
+<!entity psql     SYSTEM "psql.sgml">
 <!entity query-ug SYSTEM "query-ug.sgml">
 <!entity storage  SYSTEM "storage.sgml">
-<!entity psql     SYSTEM "psql.sgml">
-<!entity pgaccess SYSTEM "pgaccess.sgml">
+<!entity syntax   SYSTEM "syntax.sgml">
+<!entity typeconv SYSTEM "typeconv.sgml">
 
 <!-- reference pages -->
 <!entity % allfiles SYSTEM "ref/allfiles.sgml">
@@ -134,25 +139,25 @@ Move SQL reference pages up into the User's Guide.
 <!-- entity manpages SYSTEM "man/manpages.sgml" subdoc -->
 <Book Id="postgres">
 
-<!-- Title information -->
+ <!-- Title information -->
 
-<Title>PostgreSQL</Title>
-<BookInfo>
-    <ReleaseInfo>Covering v6.4 for general release</ReleaseInfo>
-    <BookBiblio>
-    <AuthorGroup>
-      <CorpAuthor>The PostgreSQL Development Team</CorpAuthor>
-    </AuthorGroup>
+ <Title>PostgreSQL</Title>
+ <BookInfo>
+  <ReleaseInfo>Covering v6.4 for general release</ReleaseInfo>
+  <BookBiblio>
+   <AuthorGroup>
+    <CorpAuthor>The PostgreSQL Development Team</CorpAuthor>
+   </AuthorGroup>
 <!-- editor in authorgroup is not supported
     <AuthorGroup>
 -->
-      <Editor>
-        <FirstName>Thomas</FirstName>
-        <SurName>Lockhart</SurName>
-        <Affiliation>
-          <OrgName>Caltech/JPL</OrgName>
-        </Affiliation>
-      </Editor>
+   <Editor>
+    <FirstName>Thomas</FirstName>
+    <SurName>Lockhart</SurName>
+    <Affiliation>
+     <OrgName>Caltech/JPL</OrgName>
+    </Affiliation>
+   </Editor>
 <!--
     </AuthorGroup>
 -->
@@ -161,17 +166,17 @@ Move SQL reference pages up into the User's Guide.
     <AuthorInitials>TGL</AuthorInitials>
 -->
 
-    <Date>(last updated 1998-02-23)</Date>
-    </BookBiblio>
+   <Date>(last updated 1998-02-23)</Date>
+  </BookBiblio>
 
-<LegalNotice>
-<Para>
-<ProductName>PostgreSQL</ProductName> is copyright (C) 1998 
-by the Postgres Global Development Group.
-</Para>
-</LegalNotice>
+  <LegalNotice>
+   <Para>
+    <ProductName>PostgreSQL</ProductName> is copyright (C) 1998 
+    by the Postgres Global Development Group.
+   </Para>
+  </LegalNotice>
 
-</BookInfo>
+ </BookInfo>
 
 <!--
 <TOC> </TOC>
@@ -186,146 +191,147 @@ Your name here...
 </Dedication>
 -->
 
-<preface id="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/SQL3 language support,
- transaction integrity, and type extensibility.
- <ProductName>PostgreSQL</ProductName> is a public-domain,
- open source descendant of this original Berkeley code.
-</Para>
-</Preface>
-
-<part Id="part-tutorial">
-<Title>Tutorial</Title>
-<PartIntro>
-<Para>
-Introduction for new users.
-</Para>
-</PartIntro>
-&intro;
-&arch;
-&start;
-&query;
-&advanced;
-</Part>
-
-<part Id="part-user">
-<Title>User's Guide</Title>
-<PartIntro>
-<Para>
-Information for users.
-</Para>
-</PartIntro>
-&environ;
-&manage;
-&datatype;
-&oper;
-&func;
-&typeconv;
-&keys;
-&array;
-&inherit;
-&query-ug;
-&storage;
-&psql;
-&pgaccess;
-&commands;
-</Part>
-
-<part Id="part-admin">
-<Title>Administrator's Guide</Title>
-<PartIntro>
-<Para>
-Installation and maintenance information.
-</Para>
-</PartIntro>
-&intro-ag;
-&ports;
-&config;
-&install;
-&installw;
-&runtime;
-&options;
-&start-ag;
-&recovery;
-&regress;
-&release;
-</Part>
-
-<part Id="part-programmer">
-<Title>Programmer's Guide</Title>
-<PartIntro>
-<Para>
-Information for extending <ProductName>Postgres</ProductName>.
-</Para>
-</PartIntro>
-&intro-pg;
-&arch-pg;
-&extend;
-&xfunc;
-&xtypes;
-&xoper;
-&xaggr;
-&rules;
-&xindex;
-&gist;
-&dfunc;
-&trigger;
-&spi;
-&xplang;
-<!-- &libpq; -->
-</Part>
-
-<part Id="part-interfaces">
-<Title>Interfaces</Title>
-<PartIntro>
-<Para>
-User and programmer interfaces.
-</Para>
-</PartIntro>
-&func-ref;
-&lobj;
-&ecpg;
-&libpq;
-&libpgtcl;
-&odbc;
-&jdbc;
-</Part>
-
-<part Id="part-developer">
-<Title>Developer's Guide</Title>
-<PartIntro>
-<Para>
-The Developer's Guide includes discussion of design decisions and 
-suggestions for future development.
-</Para>
-</PartIntro>
-&arch-dev;
-&geqo;
-&protocol;
-&signals;
-&compiler;
-&bki;
-&page;
-</Part>
-
-<part Id="part-appendix">
-<Title>Appendices</Title>
-<PartIntro>
-<Para>
-Additional related information.
-</Para>
-</PartIntro>
-&docguide;
-&contacts;
-&biblio;
-</Part>
+ <preface id="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/SQL3 language support,
+   transaction integrity, and type extensibility.
+   <ProductName>PostgreSQL</ProductName> is a public-domain,
+   open source descendant of this original Berkeley code.
+  </Para>
+ </Preface>
+
+ <part Id="part-tutorial">
+  <Title>Tutorial</Title>
+  <PartIntro>
+   <Para>
+    Introduction for new users.
+   </Para>
+  </PartIntro>
+   &intro;
+   &arch;
+   &start;
+   &query;
+   &advanced;
+ </Part>
+
+ <part Id="part-user">
+  <Title>User's Guide</Title>
+  <PartIntro>
+   <Para>
+    Information for users.
+   </Para>
+  </PartIntro>
+   &environ;
+   &manage;
+  &syntax;
+   &datatype;
+   &oper;
+   &func;
+   &typeconv;
+  &keys;
+   &array;
+   &inherit;
+   &query-ug;
+   &storage;
+   &psql;
+   &pgaccess;
+   &commands;
+ </Part>
+
+ <part Id="part-admin">
+  <Title>Administrator's Guide</Title>
+  <PartIntro>
+   <Para>
+    Installation and maintenance information.
+   </Para>
+  </PartIntro>
+   &intro-ag;
+   &ports;
+   &config;
+   &install;
+  &installw;
+   &runtime;
+   &options;
+  &start-ag;
+   &recovery;
+   &regress;
+   &release;
+ </Part>
+
+ <part Id="part-programmer">
+  <Title>Programmer's Guide</Title>
+  <PartIntro>
+   <Para>
+    Information for extending <ProductName>Postgres</ProductName>.
+   </Para>
+  </PartIntro>
+   &intro-pg;
+   &arch-pg;
+   &extend;
+   &xfunc;
+   &xtypes;
+   &xoper;
+   &xaggr;
+   &rules;
+   &xindex;
+   &gist;
+   &dfunc;
+   &trigger;
+   &spi;
+   &xplang;
+  <!-- &libpq; -->
+ </Part>
+
+ <part Id="part-interfaces">
+  <Title>Interfaces</Title>
+  <PartIntro>
+   <Para>
+    User and programmer interfaces.
+   </Para>
+  </PartIntro>
+   &func-ref;
+   &lobj;
+   &ecpg;
+   &libpq;
+   &libpgtcl;
+   &odbc;
+   &jdbc;
+ </Part>
+ 
+ <part Id="part-developer">
+  <Title>Developer's Guide</Title>
+  <PartIntro>
+   <Para>
+    The Developer's Guide includes discussion of design decisions and 
+    suggestions for future development.
+   </Para>
+  </PartIntro>
+   &arch-dev;
+   &geqo;
+   &protocol;
+   &signals;
+   &compiler;
+   &bki;
+   &page;
+ </Part>
+ 
+ <part Id="part-appendix">
+  <Title>Appendices</Title>
+  <PartIntro>
+   <Para>
+    Additional related information.
+   </Para>
+  </PartIntro>
+  &docguide;
+   &contacts;
+   &biblio;
+ </Part>
 
 <!--
 Omit index until we have some index entries.
-- 
GitLab