# Postgres documentation makefile
-# $Header: /cvsroot/pgsql/doc/src/Makefile,v 1.14 2000/10/08 13:24:08 petere Exp $
+# $Header: /cvsroot/pgsql/doc/src/Makefile,v 1.15 2000/11/24 17:44:21 petere Exp $
subdir = doc/src
top_builddir = ../..
--include $(top_builddir)/src/Makefile.global
+include $(top_builddir)/src/Makefile.global
TAR= tar
ZIP= gzip
ZIPSUFFIX= gz
TAREXCLUDE= --exclude=Makefile --exclude='*.sgml' --exclude=ref
-SRC= admin postgres programmer tutorial user developer
+SRC= admin developer reference programmer tutorial user postgres
TARGETS= $(SRC:%=%.tar.$(ZIPSUFFIX))
sources.tar:
$(TAR) -cf $@ sgml graphics
-admin.tar:
+admin.tar developer.tar reference.tar user.tar:
$(MAKE) -C sgml clean
- $(MAKE) -C sgml admin.html
- cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm
-
-developer.tar:
- $(MAKE) -C sgml clean
- $(MAKE) -C sgml developer.html
+ $(MAKE) -C sgml $(basename $@).html
cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm
programmer.tar:
$(MAKE) -C sgml tutorial.html
cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm -C ../graphics clientserver.gif
-user.tar:
- $(MAKE) -C sgml clean
- $(MAKE) -C sgml user.html
- cd sgml && $(TAR) -cf ../$@ $(TAREXCLUDE) *.html *.htm
-
postgres.tar:
$(MAKE) -C sgml clean
$(MAKE) -C sgml postgres.html
#
#
# IDENTIFICATION
-# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.25 2000/11/05 21:04:06 petere Exp $
+# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.26 2000/11/24 17:44:21 petere Exp $
#
#----------------------------------------------------------------------------
vpath %.sgml ./ref
-ALLDOCUMENTS = admin user programmer developer tutorial postgres
+ALLBOOKS = admin developer programmer reference tutorial user
ALLSGML := $(wildcard $(srcdir)/*.sgml $(srcdir)/ref/*.sgml)
## HTML
##
-%.html: %.sgml $(ALLSGML)
+JADE.html = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -d $(HDSL) -V %use-id-as-filename% -t sgml
+
+postgres.html: postgres.sgml $(ALLSGML)
@rm -f *.htm
- $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -d $(HDSL) -V %use-id-as-filename% -t sgml $<
+ $(JADE.html) $<
# Include some softlinks to the generic default file names
+ ln -sf postgres.htm index.html
+ ln -sf postgres.htm postgres.html
+
+$(addsuffix .html, $(ALLBOOKS)): %.html: %.sgml $(ALLSGML)
+ @rm -f *.htm
+ $(JADE.html) book-decl.sgml $<
ln -sf $*.htm index.html
ln -sf $*.htm $*.html
##
# RTF to allow minor editing for hardcopy
-%.rtf: %.sgml
- $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -d $(PDSL) -t rtf $<
+$(addsuffix .rtf, $(ALLBOOKS)): %.rtf: %.sgml $(ALLSGML)
+ $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -d $(PDSL) -t rtf book-decl.sgml $<
# TeX and DVI
-%.tex: %.sgml
- $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -d $(PDSL) -t tex $<
+$(addsuffix .tex, $(ALLBOOKS)): %.tex: %.sgml $(ALLSGML)
+ $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -d $(PDSL) -t tex book-decl.sgml $<
%.dvi: %.tex
jadetex $<
## Check
##
-check: $(addprefix check-, $(ALLDOCUMENTS))
+check: $(addprefix check-, $(ALLBOOKS)) check-postgres
# Quick syntax check without style processing
-check-%: %.sgml
+$(addprefix check-, $(ALLBOOKS)): check-%: %.sgml
+ $(NSGMLS) $(SGMLINCLUDE) -s book-decl.sgml $<
+
+check-postgres: postgres.sgml
$(NSGMLS) $(SGMLINCLUDE) -s $<
<para>
<productname>PostgreSQL</productname> is available without cost. This manual
- describes version 7.0 of <productname>PostgreSQL</productname>.
+ describes version &version; of <productname>PostgreSQL</productname>.
</para>
<para>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.27 2000/09/30 16:58:20 petere Exp $
-
-Postgres Administrator's Guide.
-Derived from postgres.sgml.
-- thomas 1998-10-27
+$Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.28 2000/11/24 17:44:21 petere Exp $
-->
-<!doctype book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-
-<!entity version "7.1">
-<!entity majorversion "7.1">
-
-<!entity about SYSTEM "about.sgml">
-<!entity history SYSTEM "history.sgml">
-<!entity info SYSTEM "info.sgml">
-<!entity legal SYSTEM "legal.sgml">
-<!entity notation SYSTEM "notation.sgml">
-<!entity problems SYSTEM "problems.sgml">
-<!entity y2k SYSTEM "y2k.sgml">
-
-<!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">
-<!entity recovery SYSTEM "recovery.sgml">
-<!entity regress SYSTEM "regress.sgml">
-<!entity release SYSTEM "release.sgml">
-<!entity runtime SYSTEM "runtime.sgml">
-<!entity user-manag SYSTEM "user-manag.sgml">
-
-<!entity biblio SYSTEM "biblio.sgml">
-
-<!-- see standalone-install.sgml about these -->
-<!entity % flattext-install-ignore "INCLUDE">
-<!entity % flattext-install-include "IGNORE">
-]>
-
<book id="admin">
<!-- Title information -->
- <title>PostgreSQL Administrator's Guide</title>
+ <title><![%single-book;[PostgreSQL &version;]]> Administrator's Guide</title>
<bookinfo>
- <releaseinfo>Covering v7.0 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>
-<!--
- </AuthorGroup>
--->
-
-<!--
- <AuthorInitials>TGL</AuthorInitials>
--->
+ <corpauthor>The PostgreSQL Global Development Group</corpauthor>
- <date>(last updated 2000-05-01)</date>
- </bookbiblio>
+ <editor>
+ <firstname>Thomas</firstname>
+ <surname>Lockhart</surname>
+ <affiliation>
+ <orgname>Caltech/JPL</orgname>
+ </affiliation>
+ </editor>
<legalnotice>
<para>
</bookinfo>
- <preface id="preface">
+ <preface id="ag-preface">
<title>Summary</title>
<para>
</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;
+]]>
&installation;
&installw;
&runtime;
&recovery;
®ress;
&release;
-
+<![%single-book;[
&biblio;
-
-<!--
-Don't bother with an index until we get some index entries.
-- thomas 1998-10-26
-<index id="index">
-</index>
--->
-
+]]>
</book>
<!-- Keep this comment at the end of the file
--- /dev/null
+<!doctype book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
+
+<!entity % version SYSTEM "version.sgml">
+%version;
+<!entity % filelist SYSTEM "filelist.sgml">
+%filelist;
+
+<!entity % set-of-books "IGNORE">
+<!entity % single-book "INCLUDE">
+
+]>
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/Attic/developer.sgml,v 1.1 2000/10/08 13:24:09 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/Attic/developer.sgml,v 1.2 2000/11/24 17:44:21 petere Exp $ -->
<!-- PostgreSQL Developer's Guide -->
-<!doctype book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-
-<!entity about SYSTEM "about.sgml">
-<!entity history SYSTEM "history.sgml">
-<!entity info SYSTEM "info.sgml">
-<!entity legal SYSTEM "legal.sgml">
-<!entity notation SYSTEM "notation.sgml">
-<!entity problems SYSTEM "problems.sgml">
-<!entity y2k SYSTEM "y2k.sgml">
-
-<!entity arch-dev SYSTEM "arch-dev.sgml">
-<!entity biblio SYSTEM "biblio.sgml">
-<!entity bki SYSTEM "bki.sgml">
-<!entity catalogs SYSTEM "catalogs.sgml">
-<!entity compiler SYSTEM "compiler.sgml">
-<!entity contacts SYSTEM "contacts.sgml">
-<!entity cvs SYSTEM "cvs.sgml">
-<!entity docguide SYSTEM "docguide.sgml">
-<!entity geqo SYSTEM "geqo.sgml">
-<!entity page SYSTEM "page.sgml">
-<!entity protocol SYSTEM "protocol.sgml">
-<!entity sources SYSTEM "sources.sgml">
-
-]>
-
<book id="developer">
- <title><productname>PostgreSQL Developer's Guide</></>
+ <title><![%single-book;[PostgreSQL &version;]]> Developer's Guide</title>
<bookinfo>
<abstract>
</simpara>
</abstract>
- <corpauthor>The PostgreSQL Global Development Group</>
+ <corpauthor>The PostgreSQL Global Development Group</corpauthor>
</bookinfo>
&sources;
&compiler;
&bki;
&page;
+<![%single-book;[
&biblio;
-
+]]>
<!-- appendices -->
&cvs;
&docguide;
--- /dev/null
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/filelist.sgml,v 1.1 2000/11/24 17:44:21 petere Exp $ -->
+
+<!entity about SYSTEM "about.sgml">
+<!entity history SYSTEM "history.sgml">
+<!entity info SYSTEM "info.sgml">
+<!entity legal SYSTEM "legal.sgml">
+<!entity notation SYSTEM "notation.sgml">
+<!entity problems SYSTEM "problems.sgml">
+<!entity y2k SYSTEM "y2k.sgml">
+
+<!-- tutorial -->
+<!entity arch SYSTEM "arch.sgml">
+<!entity intro SYSTEM "intro.sgml">
+<!entity query SYSTEM "query.sgml">
+<!entity sql SYSTEM "sql.sgml">
+<!entity start SYSTEM "start.sgml">
+
+<!-- user's guide -->
+<!entity advanced SYSTEM "advanced.sgml">
+<!entity array SYSTEM "array.sgml">
+<!entity datatype SYSTEM "datatype.sgml">
+<!entity datetime SYSTEM "datetime.sgml">
+<!entity environ SYSTEM "environ.sgml">
+<!entity func SYSTEM "func.sgml">
+<!entity indices SYSTEM "indices.sgml">
+<!entity inherit SYSTEM "inherit.sgml">
+<!entity manage SYSTEM "manage.sgml">
+<!entity mvcc SYSTEM "mvcc.sgml">
+<!entity oper SYSTEM "oper.sgml">
+<!entity plan SYSTEM "plan.sgml">
+<!entity plperl SYSTEM "plperl.sgml">
+<!entity plsql SYSTEM "plsql.sgml">
+<!entity pltcl SYSTEM "pltcl.sgml">
+<!entity populate SYSTEM "populate.sgml">
+<!entity psql SYSTEM "psql.sgml">
+<!entity query-ug SYSTEM "query-ug.sgml">
+<!entity storage SYSTEM "storage.sgml">
+<!entity syntax SYSTEM "syntax.sgml">
+<!entity typeconv SYSTEM "typeconv.sgml">
+
+<!-- reference pages -->
+<!entity % allfiles SYSTEM "ref/allfiles.sgml">
+%allfiles;
+
+<!-- administrator's guide -->
+<!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">
+<!entity recovery SYSTEM "recovery.sgml">
+<!entity regress SYSTEM "regress.sgml">
+<!entity release SYSTEM "release.sgml">
+<!entity runtime SYSTEM "runtime.sgml">
+<!entity user-manag SYSTEM "user-manag.sgml">
+
+<!-- programmer's guide -->
+<!entity arch-pg SYSTEM "arch-pg.sgml">
+<!entity dfunc SYSTEM "dfunc.sgml">
+<!entity ecpg SYSTEM "ecpg.sgml">
+<!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">
+<!entity libpq SYSTEM "libpq.sgml">
+<!entity libpqpp SYSTEM "libpq++.sgml">
+<!entity libpgtcl SYSTEM "libpgtcl.sgml">
+<!entity lisp SYSTEM "lisp.sgml">
+<!entity lobj SYSTEM "lobj.sgml">
+<!entity odbc SYSTEM "odbc.sgml">
+<!entity rules SYSTEM "rules.sgml">
+<!entity spi SYSTEM "spi.sgml">
+<!entity trigger SYSTEM "trigger.sgml">
+<!entity xaggr SYSTEM "xaggr.sgml">
+<!entity xfunc SYSTEM "xfunc.sgml">
+<!entity xindex SYSTEM "xindex.sgml">
+<!entity xplang SYSTEM "xplang.sgml">
+<!entity xoper SYSTEM "xoper.sgml">
+<!entity xtypes SYSTEM "xtypes.sgml">
+
+<!-- developer's guide -->
+<!entity arch-dev SYSTEM "arch-dev.sgml">
+<!entity biblio SYSTEM "biblio.sgml">
+<!entity bki SYSTEM "bki.sgml">
+<!entity catalogs SYSTEM "catalogs.sgml">
+<!entity compiler SYSTEM "compiler.sgml">
+<!entity contacts SYSTEM "contacts.sgml">
+<!entity cvs SYSTEM "cvs.sgml">
+<!entity docguide SYSTEM "docguide.sgml">
+<!entity geqo SYSTEM "geqo.sgml">
+<!entity index SYSTEM "index.sgml">
+<!entity page SYSTEM "page.sgml">
+<!entity protocol SYSTEM "protocol.sgml">
+<!entity sources SYSTEM "sources.sgml">
+
+<!-- see standalone-install.sgml about these -->
+<!entity % flattext-install-ignore "INCLUDE">
+<!entity % flattext-install-include "IGNORE">
</para>
<para>
- Use <xref endterm="sql-dropindex-title"
- linkend="sql-dropindex-title">
- to remove an index.
+ Use <command>DROP INDEX</command> to remove an index.
</para>
<sect1 id="keys">
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.43 2000/10/08 13:24:09 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/postgres.sgml,v 1.44 2000/11/24 17:44:21 petere Exp $
-->
<!doctype set PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-<!entity version "7.1">
-<!entity majorversion "7.1">
+<!entity % version SYSTEM "version.sgml">
+%version;
+<!entity % filelist SYSTEM "filelist.sgml">
+%filelist;
-<!entity about SYSTEM "about.sgml">
-<!entity history SYSTEM "history.sgml">
-<!entity info SYSTEM "info.sgml">
-<!entity legal SYSTEM "legal.sgml">
-<!entity notation SYSTEM "notation.sgml">
-<!entity problems SYSTEM "problems.sgml">
-<!entity y2k SYSTEM "y2k.sgml">
+<!entity % set-of-books "INCLUDE">
+<!entity % single-book "IGNORE">
-<!-- tutorial -->
-<!entity arch SYSTEM "arch.sgml">
-<!entity intro SYSTEM "intro.sgml">
-<!entity query SYSTEM "query.sgml">
-<!entity sql SYSTEM "sql.sgml">
-<!entity start SYSTEM "start.sgml">
-
-<!-- user's guide -->
-<!entity advanced SYSTEM "advanced.sgml">
-<!entity array SYSTEM "array.sgml">
-<!entity datatype SYSTEM "datatype.sgml">
-<!entity datetime SYSTEM "datetime.sgml">
-<!entity environ SYSTEM "environ.sgml">
-<!entity func SYSTEM "func.sgml">
-<!entity indices SYSTEM "indices.sgml">
-<!entity inherit SYSTEM "inherit.sgml">
-<!entity manage SYSTEM "manage.sgml">
-<!entity mvcc SYSTEM "mvcc.sgml">
-<!entity oper SYSTEM "oper.sgml">
-<!entity plan SYSTEM "plan.sgml">
-<!entity plperl SYSTEM "plperl.sgml">
-<!entity plsql SYSTEM "plsql.sgml">
-<!entity pltcl SYSTEM "pltcl.sgml">
-<!entity populate SYSTEM "populate.sgml">
-<!entity psql SYSTEM "psql.sgml">
-<!entity query-ug SYSTEM "query-ug.sgml">
-<!entity storage SYSTEM "storage.sgml">
-<!entity syntax SYSTEM "syntax.sgml">
-<!entity typeconv SYSTEM "typeconv.sgml">
-
-<!-- reference pages -->
-<!entity % allfiles SYSTEM "ref/allfiles.sgml">
-%allfiles;
-
-<!-- administrator's guide -->
-<!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">
-<!entity recovery SYSTEM "recovery.sgml">
-<!entity regress SYSTEM "regress.sgml">
-<!entity release SYSTEM "release.sgml">
-<!entity runtime SYSTEM "runtime.sgml">
-<!entity user-manag SYSTEM "user-manag.sgml">
-
-<!-- programmer's guide -->
-<!entity arch-pg SYSTEM "arch-pg.sgml">
-<!entity dfunc SYSTEM "dfunc.sgml">
-<!entity ecpg SYSTEM "ecpg.sgml">
-<!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">
-<!entity libpq SYSTEM "libpq.sgml">
-<!entity libpqpp SYSTEM "libpq++.sgml">
-<!entity libpgtcl SYSTEM "libpgtcl.sgml">
-<!entity lisp SYSTEM "lisp.sgml">
-<!entity lobj SYSTEM "lobj.sgml">
-<!entity odbc SYSTEM "odbc.sgml">
-<!entity rules SYSTEM "rules.sgml">
-<!entity spi SYSTEM "spi.sgml">
-<!entity trigger SYSTEM "trigger.sgml">
-<!entity xaggr SYSTEM "xaggr.sgml">
-<!entity xfunc SYSTEM "xfunc.sgml">
-<!entity xindex SYSTEM "xindex.sgml">
-<!entity xplang SYSTEM "xplang.sgml">
-<!entity xoper SYSTEM "xoper.sgml">
-<!entity xtypes SYSTEM "xtypes.sgml">
-
-<!-- developer's guide -->
-<!entity arch-dev SYSTEM "arch-dev.sgml">
-<!entity biblio SYSTEM "biblio.sgml">
-<!entity bki SYSTEM "bki.sgml">
-<!entity catalogs SYSTEM "catalogs.sgml">
-<!entity compiler SYSTEM "compiler.sgml">
-<!entity contacts SYSTEM "contacts.sgml">
-<!entity cvs SYSTEM "cvs.sgml">
-<!entity docguide SYSTEM "docguide.sgml">
-<!entity geqo SYSTEM "geqo.sgml">
-<!entity index SYSTEM "index.sgml">
-<!entity page SYSTEM "page.sgml">
-<!entity protocol SYSTEM "protocol.sgml">
-<!entity sources SYSTEM "sources.sgml">
-
-
-<!-- see standalone-install.sgml about these -->
-<!entity % flattext-install-ignore "INCLUDE">
-<!entity % flattext-install-include "IGNORE">
+<!entity admin SYSTEM "admin.sgml">
+<!entity developer SYSTEM "developer.sgml">
+<!entity programmer SYSTEM "programmer.sgml">
+<!entity reference SYSTEM "reference.sgml">
+<!entity tutorial SYSTEM "tutorial.sgml">
+<!entity user SYSTEM "user.sgml">
]>
-<!-- entity manpages SYSTEM "man/manpages.sgml" subdoc -->
<set id="postgres">
- <title>PostgreSQL Documentation</title>
-
- <book id="user">
- <title>User's Guide</title>
-
- <bookinfo>
- <abstract>
- <para>
- Information for Users
- </para>
- </abstract>
- </bookinfo>
-
- &intro;
- &syntax;
- &datatype;
- &oper;
- &func;
- &typeconv;
- &indices;
- &array;
- &inherit;
- &plsql;
- &pltcl;
- &plperl;
- &mvcc;
- &environ;
- &manage;
- &storage;
- &plan;
- &populate;
- &commands;
-
- &datetime;
-<!--
- &contacts;
--->
- &biblio;
- </book>
-
- <book id="admin">
- <title>Administrator's Guide</title>
-
- <bookinfo>
- <abstract>
- <para>
- Information for Administrators
- </para>
- </abstract>
- </bookinfo>
-
-<!--
- 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.
- &intro-ag;
--->
- &installation;
- &installw;
- &runtime;
- &client-auth;
- &charset;
- &manage-ag;
- &user-manag;
- &backup;
- &recovery;
- ®ress;
- &release;
- </book>
-
- <book id="programmer">
- <title>Programmer's Guide</title>
-
- <bookinfo>
- <abstract>
- <para>
- Information on client and server programming
- </para>
- </abstract>
- </bookinfo>
-
-<!--
- 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.
- &intro-pg;
--->
- <part>
- <title>Server Programming</title>
- &arch-pg;
- &extend;
- &xfunc;
- &xtypes;
- &xoper;
- &xaggr;
- &rules;
- &xindex;
- &indexcost;
- &gist;
- &dfunc;
- &trigger;
- &spi;
- &xplang;
- </part>
-
- <part>
- <title>Client Interfaces</title>
- &func-ref;
- &lobj;
- &ecpg;
- &libpq;
- &libpqpp;
- &libpgtcl;
- &libpgeasy;
- &odbc;
- &jdbc;
- &lisp;
- </part>
- </book>
-
- <book id="developer">
- <title>Developer's Guide</title>
- <bookinfo>
- <abstract>
- <para>
- Information for Postgres developers
- </>
- </>
- </bookinfo>
-
- &sources;
- &arch-dev;
- &geqo;
-<!--
- This listing of Postgres catalogs is currently just a copy of the old
- man page. It is not up to date and has not been marked up for SGML.
- - thomas 2000-04-20
- &catalogs;
--->
- &protocol;
- &compiler;
- &bki;
- &page;
- &cvs;
- &docguide;
- </book>
-
- <book id="tutorial">
- <title>Tutorial</title>
- &sql;
- &arch;
- &start;
- &query;
- &advanced;
- </book>
-
-
-<!--
-Omit index until we have some index entries.
-- thomas 1998-10-26
-<index Id="part-index">
-</index>
--->
+ <title>PostgreSQL &version; Documentation</title>
+
+ <setinfo>
+ <corpauthor>The PostgreSQL Global Development Group</corpauthor>
+ </setinfo>
+
+ &tutorial;
+ &user;
+ &admin;
+ &programmer;
+ &reference;
+ &developer;
</set>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/Attic/programmer.sgml,v 1.28 2000/10/08 13:24:09 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/Attic/programmer.sgml,v 1.29 2000/11/24 17:44:21 petere Exp $
-Postgres Programmer's Guide.
+PostgreSQL Programmer's Guide.
-->
-<!doctype book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-
-<!entity about SYSTEM "about.sgml">
-<!entity history SYSTEM "history.sgml">
-<!entity info SYSTEM "info.sgml">
-<!entity legal SYSTEM "legal.sgml">
-<!entity notation SYSTEM "notation.sgml">
-<!entity problems SYSTEM "problems.sgml">
-<!entity y2k SYSTEM "y2k.sgml">
-
-<!entity arch-pg SYSTEM "arch-pg.sgml">
-<!entity dfunc SYSTEM "dfunc.sgml">
-<!entity ecpg SYSTEM "ecpg.sgml">
-<!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">
-<!entity libpq SYSTEM "libpq.sgml">
-<!entity libpqpp SYSTEM "libpq++.sgml">
-<!entity libpgtcl SYSTEM "libpgtcl.sgml">
-<!entity lisp SYSTEM "lisp.sgml">
-<!entity lobj SYSTEM "lobj.sgml">
-<!entity odbc SYSTEM "odbc.sgml">
-<!entity rules SYSTEM "rules.sgml">
-<!entity spi SYSTEM "spi.sgml">
-<!entity trigger SYSTEM "trigger.sgml">
-<!entity xaggr SYSTEM "xaggr.sgml">
-<!entity xfunc SYSTEM "xfunc.sgml">
-<!entity xindex SYSTEM "xindex.sgml">
-<!entity xplang SYSTEM "xplang.sgml">
-<!entity xoper SYSTEM "xoper.sgml">
-<!entity xtypes SYSTEM "xtypes.sgml">
-<!entity biblio SYSTEM "biblio.sgml">
-]>
-
<book id="programmer">
-<!-- Title information -->
-
- <title>PostgreSQL Programmer's Guide</title>
+ <title><![%single-book;[PostgreSQL &version;]]> Programmer's Guide</title>
<bookinfo>
- <releaseinfo>Covering v7.0 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>
-<!--
- </AuthorGroup>
--->
-
-<!--
- <AuthorInitials>TGL</AuthorInitials>
--->
+ <corpauthor>The PostgreSQL Global Development Group</corpauthor>
- <date>(last updated 2000-05-01)</date>
- </bookbiblio>
+ <editor>
+ <firstname>Thomas</firstname>
+ <surname>Lockhart</surname>
+ <affiliation>
+ <orgname>Caltech/JPL</orgname>
+ </affiliation>
+ </editor>
<legalnotice>
<para>
</bookinfo>
-<!--
-<TOC> </TOC>
-<LOT> </LOT>
--->
-
-<!--
-<Dedication>
-<Para>
-Your name here...
-</Para>
-</Dedication>
--->
-
- <preface id="preface">
+ <preface id="pg-preface">
<title>Summary</title>
<para>
</para>
</preface>
+<![%single-book[
&intro-pg;
- <part>
- <title>Server Programming</>
+]]>
+
+ <part id="programmer-client">
+ <title>Client Interfaces</title>
+ &libpq;
+ &lobj;
+ &libpqpp;
+ &libpgtcl;
+ &libpgeasy;
+ &ecpg;
+ &odbc;
+ &jdbc;
+ &lisp;
+ </part>
+
+ <part id="programmer-server">
+ <title>Server Programming</title>
&arch-pg;
&extend;
&xfunc;
&trigger;
&spi;
</part>
- <part>
- <title>Client Interfaces</>
- &lobj;
- &libpq;
- &libpqpp;
- &libpgtcl;
- &libpgeasy;
- &ecpg;
- &odbc;
- &jdbc;
- &lisp;
- </part>
-<!--
-&contacts;
--->
- &biblio;
-<!--
-<index id="index">
-</index>
--->
+<![%single-book;[
+ &biblio;
+]]>
</book>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.24 2000/10/16 03:34:47 pjw Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.25 2000/11/24 17:44:22 petere Exp $
Postgres documentation
Complete list of usable sgml source files in this directory.
-->
-<!entity intro-ref system "intro-ref.sgml">
-<!entity commands system "commands.sgml">
-
<!-- these will go into the "operators" reference chapter -->
<!entity all system "all.sgml">
<!entity any system "any.sgml">
<!entity trim system "trim.sgml">
<!entity upper system "upper.sgml">
-<!-- these are in the "commands" reference chapter -->
+<!-- SQL commands -->
<!entity abort system "abort.sgml">
<!entity alterGroup system "alter_group.sgml">
<!entity alterTable system "alter_table.sgml">
<!entity update system "update.sgml">
<!entity vacuum system "vacuum.sgml">
-<!-- these are in the "utilities" reference chapter -->
+<!-- applications and utilities -->
<!entity createdb system "createdb.sgml">
<!entity createlang system "createlang.sgml">
<!entity createuser system "createuser.sgml">
+++ /dev/null
-<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/commands.sgml,v 1.29 2000/10/18 13:29:23 pjw Exp $
-Postgres documentation
--->
-
- <chapter id="sql-commands">
- <Title>SQL Commands</Title>
-
- <abstract>
- <Para>
- This is reference information for the <acronym>SQL</acronym>
- commands supported by <productname>Postgres</productname>.
- </Para>
- </abstract>
-
- &abort;
- &alterGroup;
- &alterTable;
- &alterUser;
- &begin;
- &close;
- &cluster;
- &commentOn;
- &commit;
- ©Table;
- &createAggregate;
- &createConstraint;
- &createDatabase;
- &createFunction;
- &createGroup;
- &createIndex;
- &createLanguage;
- &createOperator;
- &createRule;
- &createSequence;
- &createTable;
- &createTableAs;
- &createTrigger;
- &createType;
- &createUser;
- &createView;
- &declare;
- &delete;
- &dropAggregate;
- &dropDatabase;
- &dropFunction;
- &dropGroup;
- &dropIndex;
- &dropLanguage;
- &dropOperator;
- &dropRule;
- &dropSequence;
- &dropTable;
- &dropTrigger;
- &dropType
- &dropUser;
- &dropView;
- &end;
- &explain;
- &fetch;
- &grant;
- &insert;
- &listen;
- &load;
- &lock;
- &move;
- ¬ify;
- &reindex;
- &reset;
- &revoke;
- &rollback;
- &select;
- &selectInto;
- &set;
- &setConstraints;
- &setSession;
- &setTransaction;
- &show;
- &truncate;
- &unlisten;
- &update;
- &vacuum;
-
- </Chapter>
-
-<!--
-Disable this chapter until we have more functions documented.
-- thomas 1998-10-27
-
-<chapter Id="sql-functions">
-<title>SQL Functions</title>
-
-<para>
-This chapter provides reference information for the <acronym>SQL</acronym>
-functions supported by <productname>Postgres</productname>.
-</para>
-
-¤tDate;
-¤tTime;
-¤tTimestamp;
-¤tUser;
-
-</chapter>
-
--->
-
- <chapter Id="applications">
- <title>Applications</title>
-
- <abstract>
- <para>
- This is reference information for
- <productname>Postgres</productname> applications
- and support utilities.
- </para>
- </abstract>
-
- &createdb;
- &createlang;
- &createuser;
- &dropdb;
- &droplang;
- &dropuser;
- &ecpgRef;
- &pgAccess;
- &pgAdmin;
- &pgConfig;
- &pgCtl;
- &pgDump;
- &pgDumpall;
- &pgRestore;
- &psqlRef;
- &pgTclSh;
- &pgTkSh;
- &vacuumdb;
-
- </chapter>
-
- <chapter Id="utilities">
- <title>System Applications</title>
-
- <abstract>
- <para>
- This is reference information for
- <productname>Postgres</productname>
- servers and support utilities.
- </para>
- </abstract>
-
- &initdb;
- &initlocation;
- &ipcclean;
- &pgPasswd;
- &pgUpgrade;
- &postgres;
- &postmaster;
-
- </chapter>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:nil
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-sgml-parent-document:nil
-sgml-default-dtd-file:"../reference.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:"/usr/lib/sgml/catalog"
-sgml-local-ecat-files:nil
-End:
--->
<!-- reference.sgml
-$Header: /cvsroot/pgsql/doc/src/sgml/reference.sgml,v 1.8 2000/05/02 20:01:52 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/reference.sgml,v 1.9 2000/11/24 17:44:22 petere Exp $
-Postgres User's Reference documentation.
-- thomas 1998-08-31
+PostgreSQL Reference Manual
-->
-<!doctype book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-<!entity intro SYSTEM "intro.sgml">
-
-<!entity % allfiles SYSTEM "ref/allfiles.sgml">
-%allfiles;
-
-<!entity biblio SYSTEM "biblio.sgml">
-<!entity contacts SYSTEM "contacts.sgml">
-]>
-
<book id="reference">
- <!-- Title information -->
-
- <title>PostgreSQL Reference Manual</title>
+ <title><![%single-book;[PostgreSQL &version;]]> Reference Manual</title>
<bookinfo>
- <releaseinfo>Covering v6.5 for general release</releaseinfo>
- <bookbiblio>
- <authorgroup>
- <author>
- <firstname>Jose</firstname>
- <surname>Soares Da Silva</surname>
- </author>
- <author>
- <firstname>Oliver</firstname>
- <surname>Elphick</surname>
- </author>
- </authorgroup>
-<!--
- <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>Oliver</firstname>
- <surname>Elphick</surname>
- </editor>
-<!--
- </AuthorGroup>
--->
-
- <date>(last updated 2000-05-01)</date>
- </bookbiblio>
+ <corpauthor>The PostgreSQL Global Development Group</corpauthor>
<legalnotice>
<para>
by PostgreSQL Inc.
</para>
</legalnotice>
-
</bookinfo>
-<!--
-<TOC> </TOC>
-<LOT> </LOT>
--->
-
-<!--
-<Dedication>
-<Para>
-Your name here...
-</Para>
-</Dedication>
--->
+ <reference id="sql-commands">
+ <title>SQL Commands</title>
- <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>
+ <partintro>
+ <para>
+ This is reference information for the <acronym>SQL</acronym>
+ commands supported by <productname>Postgres</productname>.
+ </para>
+ </partintro>
+
+ &abort;
+ &alterGroup;
+ &alterTable;
+ &alterUser;
+ &begin;
+ &close;
+ &cluster;
+ &commentOn;
+ &commit;
+ ©Table;
+ &createAggregate;
+ &createConstraint;
+ &createDatabase;
+ &createFunction;
+ &createGroup;
+ &createIndex;
+ &createLanguage;
+ &createOperator;
+ &createRule;
+ &createSequence;
+ &createTable;
+ &createTableAs;
+ &createTrigger;
+ &createType;
+ &createUser;
+ &createView;
+ &declare;
+ &delete;
+ &dropAggregate;
+ &dropDatabase;
+ &dropFunction;
+ &dropGroup;
+ &dropIndex;
+ &dropLanguage;
+ &dropOperator;
+ &dropRule;
+ &dropSequence;
+ &dropTable;
+ &dropTrigger;
+ &dropType
+ &dropUser;
+ &dropView;
+ &end;
+ &explain;
+ &fetch;
+ &grant;
+ &insert;
+ &listen;
+ &load;
+ &lock;
+ &move;
+ ¬ify;
+ &reindex;
+ &reset;
+ &revoke;
+ &rollback;
+ &select;
+ &selectInto;
+ &set;
+ &setConstraints;
+ &setSession;
+ &setTransaction;
+ &show;
+ &truncate;
+ &unlisten;
+ &update;
+ &vacuum;
+
+ </reference>
<!--
-&intro-ref;
--->
+Disable this chapter until we have more functions documented.
+- thomas 1998-10-27
- &commands;
+ <reference id="sql-functions">
+ <title>SQL Functions</title>
-<!--
-&contacts;
+ <partintro>
+ <para>
+ This part provides reference information for the
+ <acronym>SQL</acronym> functions supported by
+ <productname>Postgres</productname>.
+ </para>
+
+ ¤tDate;
+ ¤tTime;
+ ¤tTimestamp;
+ ¤tUser;
+ </reference>
-->
- &biblio;
+ <reference id="reference-client">
+ <title>Client Applications</title>
-<!--
-<index Id="index">
-</index>
--->
+ <partintro>
+ <para>
+ This is reference information for
+ <productname>Postgres</productname> client applications and
+ utilities.
+ </para>
+ </partintro>
+
+ &createdb;
+ &createuser;
+ &dropdb;
+ &dropuser;
+ &ecpgRef;
+ &pgAccess;
+ &pgAdmin;
+ &pgConfig;
+ &pgDump;
+ &pgDumpall;
+ &pgRestore;
+ &psqlRef;
+ &pgTclSh;
+ &pgTkSh;
+ &vacuumdb;
+
+ </reference>
+
+ <reference id="reference-server">
+ <title>Server Applications and Utilities</title>
+
+ <partintro>
+ <para>
+ This is reference information for
+ <productname>Postgres</productname>
+ server applications and support utilities.
+ </para>
+ </partintro>
+
+ &createlang;
+ &droplang;
+ &initdb;
+ &initlocation;
+ &ipcclean;
+ &pgCtl;
+ &pgPasswd;
+ &pgUpgrade;
+ &postgres;
+ &postmaster;
+
+ </reference>
</book>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/Attic/tutorial.sgml,v 1.10 2000/05/02 20:01:53 thomas Exp $
-
-Postgres tutorial. Derived from postgres.sgml.
-thomas 1998-02-23
+$Header: /cvsroot/pgsql/doc/src/sgml/Attic/tutorial.sgml,v 1.11 2000/11/24 17:44:22 petere Exp $
-->
-<!doctype book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-
-<!entity about SYSTEM "about.sgml">
-<!entity history SYSTEM "history.sgml">
-<!entity info SYSTEM "info.sgml">
-<!entity legal SYSTEM "legal.sgml">
-<!entity notation SYSTEM "notation.sgml">
-<!entity problems SYSTEM "problems.sgml">
-<!entity y2k SYSTEM "y2k.sgml">
-
-<!entity advanced SYSTEM "advanced.sgml">
-<!entity arch SYSTEM "arch.sgml">
-<!entity biblio SYSTEM "biblio.sgml">
-<!entity intro SYSTEM "intro.sgml">
-<!entity query SYSTEM "query.sgml">
-<!entity sql SYSTEM "sql.sgml">
-<!entity start SYSTEM "start.sgml">
-]>
-
<book id="tutorial">
-<!-- Title information -->
-
- <title>PostgreSQL Tutorial</title>
+ <title><![%single-book;[PostgreSQL &version;]]> Tutorial</title>
<bookinfo>
- <releaseinfo>Covering v7.0 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>
-<!--
- </AuthorGroup>
--->
-
-<!--
- <AuthorInitials>TGL</AuthorInitials>
--->
+ <corpauthor>The PostgreSQL Global Development Group</corpauthor>
- <date>(last updated 2000-05-01)</date>
- </bookbiblio>
+ <editor>
+ <firstname>Thomas</firstname>
+ <surname>Lockhart</surname>
+ <affiliation>
+ <orgname>Caltech/JPL</orgname>
+ </affiliation>
+ </editor>
<legalnotice>
<para>
</bookinfo>
-<!--
-<TOC> </TOC>
-<LOT> </LOT>
--->
-
-<!--
-<Dedication>
-<Para>
-Your name here...
-</Para>
-</Dedication>
--->
-
- <preface>
+ <preface id="tutorial-preface">
<title>Summary</title>
<para>
</para>
</preface>
+<![%single-book;[
&intro;
+]]>
&sql;
&arch;
&start;
&query;
&advanced;
-
+<![%single-book;[
&biblio;
-
-<!--
-<INDEX> </INDEX>
--->
+]]>
</book>
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/Attic/user.sgml,v 1.19 2000/05/02 20:01:53 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/Attic/user.sgml,v 1.20 2000/11/24 17:44:22 petere Exp $
-->
-<!doctype book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
-
-<!entity about SYSTEM "about.sgml">
-<!entity history SYSTEM "history.sgml">
-<!entity info SYSTEM "info.sgml">
-<!entity legal SYSTEM "legal.sgml">
-<!entity notation SYSTEM "notation.sgml">
-<!entity problems SYSTEM "problems.sgml">
-<!entity y2k SYSTEM "y2k.sgml">
-
-<!entity advanced SYSTEM "advanced.sgml">
-<!entity array SYSTEM "array.sgml">
-<!entity biblio SYSTEM "biblio.sgml">
-<!entity datatype SYSTEM "datatype.sgml">
-<!entity datetime SYSTEM "datetime.sgml">
-<!entity environ SYSTEM "environ.sgml">
-<!entity func SYSTEM "func.sgml">
-<!entity indices SYSTEM "indices.sgml">
-<!entity inherit SYSTEM "inherit.sgml">
-<!entity intro SYSTEM "intro.sgml">
-<!entity manage SYSTEM "manage.sgml">
-<!entity mvcc SYSTEM "mvcc.sgml">
-<!entity oper SYSTEM "oper.sgml">
-<!entity plan SYSTEM "plan.sgml">
-<!entity plperl SYSTEM "plperl.sgml">
-<!entity plsql SYSTEM "plsql.sgml">
-<!entity pltcl SYSTEM "pltcl.sgml">
-<!entity populate SYSTEM "populate.sgml">
-<!entity storage SYSTEM "storage.sgml">
-<!entity syntax SYSTEM "syntax.sgml">
-<!entity typeconv SYSTEM "typeconv.sgml">
-
-<!-- reference pages -->
-<!entity % allfiles SYSTEM "allfiles.sgml">
-%allfiles;
-]>
-
<book id="user">
<!-- Title information -->
- <title>PostgreSQL User's Guide</title>
+ <title><![%single-book;[PostgreSQL &version;]]> User's Guide</title>
<bookinfo>
- <releaseinfo>Covering v7.0 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>
-<!--
- </AuthorGroup>
--->
-
-<!--
- <AuthorInitials>TGL</AuthorInitials>
--->
+ <corpauthor>The PostgreSQL Development Team</corpauthor>
- <date>(last updated 2000-05-01)</date>
- </bookbiblio>
+ <editor>
+ <firstname>Thomas</firstname>
+ <surname>Lockhart</surname>
+ <affiliation>
+ <orgname>Caltech/JPL</orgname>
+ </affiliation>
+ </editor>
<legalnotice>
<para>
</bookinfo>
-<!--
-<TOC> </TOC>
-<LOT> </LOT>
--->
-
-<!--
-<Dedication>
-<Para>
-Your name here...
-</Para>
-</Dedication>
--->
-
- <preface id="preface">
+ <preface id="ug-preface">
<title>Summary</title>
<para>
&storage;
&plan;
&populate
- &commands;
<!-- appendices -->
&datetime;
- <!--
- &contacts;
- -->
&biblio;
-<!--
-<index Id="index">
-</index>
--->
-
</book>
<!-- Keep this comment at the end of the file
--- /dev/null
+<!--
+Update this file to propagate correct current version numbers to the
+documentation. In text, use for example &version; to refer to them.
+-->
+
+<!entity version "7.1devel">
+<!entity majorversion "7.1">