Include information on documentation products and sources.

Include tables of possible source files throughout tree.

1 files changed, 563 insertions, 21 deletions

diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml
index 3e571f33ad8..a5da8c4eaf0 100644
--- a/doc/src/sgml/docguide.sgml
+++ b/doc/src/sgml/docguide.sgml
@@ -1,4 +1,4 @@
-<appendix label="A">
+<appendix label="A" Id="docguide">
 <docinfo>
 <authorgroup>
 <author>
@@ -16,15 +16,560 @@
 <title>Documentation</title>
 
 <para>
-<productname>Postgres</productname> documentation is written using the
+The purpose of documentation is to make <productname>Postgres</productname>
+easier to learn, use, and develop.
+The documentation set should describe the <productname>Postgres</productname>
+system, language, and interfaces.
+It should be able to answer
+common questions and to allow a user to find those answers on his own
+without resorting to mailing list support.
+
+<para>
+<productname>Postgres</productname> has four primary documentation
+formats:
+
+<itemizedlist>
+<listitem><para>
+Plain text for pre-installation information.
+</para></listitem>
+<listitem><para>
+<acronym>HTML</acronym>, for on-line browsing and reference.
+</para></listitem>
+<listitem><para>
+Hardcopy, for in-depth reading and reference.
+</para></listitem>
+<listitem><para>
+<acronym>man pages</acronym>, for quick reference.
+</para></listitem>
+</itemizedlist>
+
+<para>
+Documentation sources include plain text files, man pages, and html. However,
+most new <productname>Postgres</productname> documentation will be written using the
 <firstterm>Standard Generalized Markup Language</firstterm>
-(<acronym>SGML</acronym>) <ulink url="http://www.ora.com/davenport/">
-<productname>DocBook</productname></ulink> <firstterm>Document Type
-Definition</firstterm> (<acronym>DTD</acronym>).</para>
+(<acronym>SGML</acronym>) 
+<ulink url="http://www.ora.com/davenport/"> <productname>DocBook</productname></ulink>
+ <firstterm>Document Type Definition</firstterm> (<acronym>DTD</acronym>).
+Much of the existing documentation has been or will be converted to <acronym>SGML</acronym>.
+</para>
+
+<sect1>
+<title>Documentation Roadmap</title>
+
+<para>
+Documentation has accumulated from several sources. As we integrate
+and assimilate existing documentation into a coherent documentation set,
+the older versions will become obsolete and will be removed from the
+distribution. However, this will not happen immediately, and will not
+happen to all documents at the same time. To ease the transition, and
+to help guide developers and writers, we have defined a transition roadmap.
+
+<para>
+Here is the documentation plan for v6.4:
+
+<itemizedlist>
+<listitem>
+<para>
+Convert <ulink url="sferac@bo.nettuno.it">Jose Soares Da Silva</ulink>'s
+ text-based reference pages to <acronym>SGML</acronym>
+reference sections for the User's Guide. 
+<ulink url="olly@lfix.co.uk">Oliver Elphick</ulink> is working on this
+and it is roughly half-way completed.
+
+<listitem>
+<para>
+Write more sections for the User's Guide covering areas outside the reference pages.
+This would include introductory information and suggestions for approaches to typical
+ design problems.
+
+<listitem>
+<para>
+Merge information in the existing man pages into the reference pages and User's Guide.
+
+<listitem>
+<para>
+Convert the new sgml reference pages to new man pages, replacing the existing man pages.
+Brandon Ibach is working on the conversion filter.
+
+<listitem>
+<para>
+Rebuild the User's Guide, Reference Guide, and Administrator's Guide
+(the admin guide only if we get release notes and installation
+information updated in <acronym>SGML</acronym>).
+</itemizedlist>
+
+<itemizedlist>
+<listitem><para>
+</para></listitem>
+</itemizedlist>
+
+<para>
+<table tocentry="1">
+<title><ProductName>Postgres</ProductName> Documentation Products</title>
+<tgroup cols="3">
+<thead>
+<row>
+<entry>
+File
+</entry>
+<entry>
+Description
+</entry>
+</row>
+</thead>
+
+<tbody>
+<row><entry>	./COPYRIGHT	</entry><entry>	Copyright notice	</entry></row>
+<row><entry>	./register.txt	</entry><entry>	Registration message during make	</entry></row>
+<row><entry>	./doc/postgres.tar.gz	</entry><entry>	Integrated docs (<acronym>HTML</acronym>)	</entry></row>
+<row><entry>	./doc/programmer.ps.gz	</entry><entry>	Programmer's Guide (Postscript)	</entry></row>
+<row><entry>	./doc/programmer.tar.gz	</entry><entry>	Programmer's Guide (<acronym>HTML</acronym>)	</entry></row>
+<row><entry>	./doc/reference.ps.gz	</entry><entry>	Reference Manual (Postscript)	</entry></row>
+<row><entry>	./doc/reference.tar.gz	</entry><entry>	Reference Manual (<acronym>HTML</acronym>)	</entry></row>
+<row><entry>	./doc/tutorial.ps.gz	</entry><entry>	Introduction (Postscript)	</entry></row>
+<row><entry>	./doc/tutorial.tar.gz	</entry><entry>	Introduction (<acronym>HTML</acronym>)	</entry></row>
+<row><entry>	./doc/user.ps.gz	</entry><entry>	User's Guide (Postscript)	</entry></row>
+<row><entry>	./doc/user.tar.gz	</entry><entry>	User's Guide (<acronym>HTML</acronym>)	</entry></row>
+</tbody>
+</tgroup>
+</table>
+
+<sect1>
+<title>Documentation Sources</title>
+
+<para>
+<table tocentry="1">
+<title><ProductName>Postgres</ProductName> Documentation Sources</title>
+<tgroup cols="3">
+<thead>
+<row>
+<entry>
+File
+</entry>
+<entry>
+Status
+</entry>
+</row>
+</thead>
+
+<tbody>
+<row><entry>	./doc/src/graphics/catalogs.gif	</entry><entry>	Output file	</entry></row>
+<row><entry>	./doc/src/graphics/clientserver.ag	</entry><entry>	Source file. Convert to CGM	</entry></row>
+<row><entry>	./doc/src/graphics/clientserver.gif	</entry><entry>	Output file	</entry></row>
+<row><entry>	./doc/src/graphics/connections.ag	</entry><entry>	Source file. Convert to CGM	</entry></row>
+<row><entry>	./doc/src/graphics/connections.gif	</entry><entry>	Output file	</entry></row>
+<row><entry>	./doc/src/graphics/layout.ag	</entry><entry>	Source file. Convert to CGM	</entry></row>
+<row><entry>	./doc/src/graphics/layout.gif	</entry><entry>	Output file	</entry></row>
+<row><entry>	./doc/src/sgml/spi.sgml	</entry><entry>	Converted. Original removed.	</entry></row>
+<row><entry>	./doc/src/sgml/admin.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/advanced.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/arch-dev.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/arch-pg.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/arch.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/array.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/biblio.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/compiler.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/contacts.sgml	</entry><entry>	Sample. Either complete or discard	</entry></row>
+<row><entry>	./doc/src/sgml/datatype.sgml	</entry><entry>	New document. Replaces man/pgbuiltin.3	</entry></row>
+<row><entry>	./doc/src/sgml/dfunc.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/docguide.sgml	</entry><entry>	New document.	</entry></row>
+<row><entry>	./doc/src/sgml/ecpg.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/environ.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/extend.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/func-ref.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/func.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/geqo.sgml	</entry><entry>	Converted. Original removed.	</entry></row>
+<row><entry>	./doc/src/sgml/gist.sgml	</entry><entry>	New from mailing list	</entry></row>
+<row><entry>	./doc/src/sgml/inherit.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/install.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/intro-pg.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/intro.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/jdbc.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/libpgtcl.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/libpq.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/lobj.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/manage.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/odbc.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/oper.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/pgaccess.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/ports.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/postgres.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/programmer.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/protocol.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/psql.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/query-ug.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/query.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/recovery.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/reference.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/regress.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/release.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/rules.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/start-ag.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/start.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/storage.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/trigger.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/tutorial.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/typeconv.sgml	</entry><entry>	New document	</entry></row>
+<row><entry>	./doc/src/sgml/user.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/xaggr.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/xfunc.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/xindex.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/xoper.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/xtypes.sgml	</entry><entry>	Converted	</entry></row>
+<row><entry>	./doc/src/sgml/ref/allfiles.sgml	</entry><entry>	List of files in ref/ (internal)	</entry></row>
+<row><entry>	./doc/src/sgml/ref/alter_table.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/alter_user.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/begin.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/close.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/cluster.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/commands.sgml	</entry><entry>	List of commands (internal)	</entry></row>
+<row><entry>	./doc/src/sgml/ref/commit.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/copy.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/create_aggregate.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/create_database.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/create_function.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/create_index.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/create_language.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/drop_function.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/select.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/create_operator.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/create_rule.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/create_sequence.sgml	</entry><entry>	New	</entry></row>
+<row><entry>	./doc/src/sgml/ref/create_table.sgml	</entry><entry>	New	</entry></row>
+</tbody>
+</tgroup>
+</table>
+
+<sect1>
+<title>Document Conversion Status</title>
+
+<para>
+<table tocentry="1">
+<title><ProductName>Postgres</ProductName> Documentation Sources</title>
+<tgroup cols="3">
+<thead>
+<row>
+<entry>
+File
+</entry>
+<entry>
+Status
+</entry>
+</row>
+</thead>
+
+<tbody>
+<row><entry>	./HISTORY	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./INSTALL	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/apache_logging/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/array/array_iterator.doc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/datetime/datetime_functions.doc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/earthdistance/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/int8/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/ip_and_mac/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/lo/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/mSQL-interface/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/noupdate/noup.example	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/pginterface/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/sequence/set_sequence.sql.in	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/soundex/soundex.sql.in	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/spi/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/spi/autoinc.example	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/spi/insert_username.example	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/spi/refint.example	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/spi/timetravel.example	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/string/string_io.sql.in	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/unixdate/unixdate.sql	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./contrib/userlock/user_locks.doc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/FAQ	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/FAQ_DEV	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/FAQ_FreeBSD	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/FAQ_Irix	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/FAQ_Linux	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/TODO	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/README.GEQO	</entry><entry>	Removed. Superceded by geqo.sgml	</entry></row>
+<row><entry>	./doc/README.fsync	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/README.locale	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/README.mb	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/README.mb.jp	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/README.support	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/TODO.GEQO	</entry><entry>	Removed. Superceded by geqo.sgml	</entry></row>
+<row><entry>	./doc/bug.template	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./doc/userguide.ps	</entry><entry>	Obsolete. Remove from distribution	</entry></row>
+<row><entry>	./migration/1.02_to_1.02.1	</entry><entry>	Removed (converted to SGML)	</entry></row>
+<row><entry>	./migration/1.09_to_6.0	</entry><entry>	Removed (converted to SGML)	</entry></row>
+<row><entry>	./migration/1.0_to_1.01	</entry><entry>	Removed (converted to SGML)	</entry></row>
+<row><entry>	./migration/6.0_to_6.1	</entry><entry>	Removed (converted to SGML)	</entry></row>
+<row><entry>	./migration/6.1_to_6.1.1	</entry><entry>	Removed (converted to SGML)	</entry></row>
+<row><entry>	./migration/6.1_to_6.2	</entry><entry>	Removed (converted to SGML)	</entry></row>
+<row><entry>	./migration/6.2.1_to_6.3	</entry><entry>	Removed (converted to SGML)	</entry></row>
+<row><entry>	./migration/6.2_to_6.2.1	</entry><entry>	Removed (converted to SGML)	</entry></row>
+<row><entry>	./migration/6.3.1_to_6.3.2	</entry><entry>	Removed (converted to SGML)	</entry></row>
+<row><entry>	./src/DEVELOPERS	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/access/nbtree/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/catalog/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/libpq/pg_hba.conf.sample	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/libpq/pg_ident.conf.sample	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/nodes/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/optimizer/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/optimizer/geqo/pg_geqo.sample	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/optimizer/plan/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/parser/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/port/dynloader/README.dlfcn.aix	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/regex/COPYRIGHT	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/regex/WHATSNEW	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/regex/re_format.7	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/regex/regex.3	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/storage/ipc/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/storage/lmgr/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/backend/storage/smgr/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/bin/pg_dump/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/bin/pgaccess/README.pga	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/bin/pgaccess/formdemo.sql	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/bin/pgtclsh/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/data/charset.conf	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/data/koi-alt.tab	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/data/koi-iso.tab	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/data/koi-koi.tab	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/data/koi-mac.tab	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/data/koi-win.tab	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/ecpg/ChangeLog	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/ecpg/TODO	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/jdbc/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/jdbc/README_6.3	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/jdbc/example/ImageViewer.java	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/jdbc/example/basic.java	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/jdbc/example/blobtest.java	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/jdbc/example/datestyle.java	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/jdbc/example/psql.java	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpgtcl/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlibpq0.cc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlibpq1.cc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlibpq2.cc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlibpq2.sql	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlibpq3.cc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlibpq3.sql	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlibpq4.cc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlibpq4.sql	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlibpq5.cc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlibpq5.sql	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlibpq6.cc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/examples/testlo.cc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/libpq++/man/libpq++.3	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/odbc/license.txt	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/odbc/notice.txt	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/odbc/readme.txt	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/perl5/MANIFEST	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/perl5/Changes	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/perl5/eg/example.newstyle	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/perl5/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/Announce	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/ChangeLog	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/tutorial/advanced.py	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/tutorial/advanced.pyc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/tutorial/basics.py	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/tutorial/func.py	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/tutorial/func.pyc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/tutorial/pgtools.py	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/tutorial/pgtools.pyc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/tutorial/syscat.py	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/interfaces/python/tutorial/syscat.pyc	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/ecpg.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/abort.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/alter_table.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/alter_user.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/begin.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/bki.5	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/catalogs.3	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/cleardbdir.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/close.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/cluster.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/commit.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/copy.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_aggregate.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_database.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_function.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_index.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_language.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_operator.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_rule.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_sequence.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_table.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_trigger.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_type.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_user.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_version.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/create_view.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/createdb.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/createuser.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/declare.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/delete.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/destroydb.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/destroyuser.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_aggregate.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_database.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_function.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_index.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_language.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_operator.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_rule.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_sequence.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_table.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_trigger.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_type.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_user.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/drop_view.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/end.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/explain.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/fetch.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/grant.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/initdb.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/initlocation.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/insert.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/ipcclean.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/large_objects.3	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/libpq.3	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/listen.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/load.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/lock.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/move.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/notify.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/oracle_compat.3	</entry><entry>	Obsolete. Superceded by func.sgml	</entry></row>
+<row><entry>	./src/man/page.5	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/pg_dump.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/pg_dumpall.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/pg_hba.conf.5	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/pg_passwd.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/pgbuiltin.3	</entry><entry>	Obsolete. Superceded by datatype.sgml	</entry></row>
+<row><entry>	./src/man/pgintro.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/postgres.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/postmaster.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/psql.1	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/reset.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/revoke.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/rollback.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/select.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/set.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/show.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/sql.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/update.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/man/vacuum.l	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/pl/tcl/INSTALL	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/pl/tcl/modules/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/pl/tcl/license.terms	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/pl/tcl/test/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/pl/tcl/test/runtest	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/pl/tcl/test/test.expected	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/pl/tcl/test/test_mklang.sql	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/pl/tcl/test/test_queries.sql	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/pl/tcl/test/test_setup.sql	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/test/bench/WISC-README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/test/locale/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/test/performance/results/PgSQL.970926	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/test/regress/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/test/suite/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/tools/RELEASE_CHANGES	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/tools/SQL_keywords	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/tools/backend/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/tools/backend/flow.fig	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/tools/backend/flow.jpg	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/tools/make_keywords.README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/tools/entab/entab.man	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/tools/make_diff/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/tools/mkldexport/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/tools/pgindent/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/tutorial/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./src/utils/README	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./lib/pg_hba.conf.sample	</entry><entry>	Not converted	</entry></row>
+<row><entry>	./lib/pg_geqo.sample	</entry><entry>	Not converted	</entry></row>
+</tbody>
+</tgroup>
+</table>
+
+<sect2>
+<title>Document Structure</title>
+
+<para>
+There are currently five separate documents written in DocBook. Each document
+has a container source document which defines the DocBook environment and other
+document source files. These primary source files are located in 
+<filename>doc/src/sgml/</filename>, along with many of the other source files
+used for the documentation. The primary source files are:
+
+<variablelist>
+<varlistentry>
+<term>postgres.sgml</term>
+<listitem>
+<para>
+This is the integrated document, including all other documents as <firstterm>parts</firstterm>.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>tutorial.sgml</term>
+<listitem>
+<para>
+The introductory tutorial, with examples. Does not include programming topics,
+and is intended to help a reader unfamiliar with <acronym>SQL</acronym>.
+This is the "getting started" document.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>user.sgml</term>
+<listitem>
+<para>
+The User's Guide. Includes information on data types and user-level interfaces.
+This is the place to put information on "why".
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>reference.sgml</term>
+<listitem>
+<para>
+The Reference Manual. Includes <productname>Postgres</productname> <acronym>SQL</acronym> syntax.
+This is the place to put information on "how".
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>programming.sgml</term>
+<listitem>
+<para>
+The Programmer's Guide. Includes information on <productname>Postgres</productname>
+extensibility and on the programming interfaces.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>admin.sgml</term>
+<listitem>
+<para>
+The Administrator's Guide. Include installation and release notes.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<sect1>
+<title>Introduction</title>
 
 <para>
 Packaged documentation is available in both
-<firstterm>HTML</firstterm> and <firstterm>Postscript</firstterm>
+<acronym>HTML</acronym> and <firstterm>Postscript</firstterm>
 formats. These are available as part of the standard
 <productname>Postgres</productname> installation. We discuss here
 working with the documentation sources and generating documentation
@@ -38,9 +583,6 @@ and still evolving.
 </para>
 </note></para>
 
-<sect1>
-<title>Introduction</title>
-
 <para>
 The purpose of <acronym>SGML</acronym> is to allow an author to
 specify the structure and content of a document (e.g. using the
@@ -49,20 +591,19 @@ have the document style define how that content is rendered into a
 final form (e.g. using Norm Walsh's stylesheets).</para>
 
 <para>
-See <ulink
-url="http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro.html">
+See <ulink url="http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro.html">
 Introduction to DocBook</ulink> for a nice "quickstart" summary of
-DocBook features. <ulink
-url="http://www.ora.com/homepages/dtdparse/docbook/3.0/"> DocBook
+DocBook features.
+<ulink url="http://www.ora.com/homepages/dtdparse/docbook/3.0/"> DocBook
 Elements</ulink> provides a powerful cross-reference for features of
 <productname>DocBook</productname>.</para>
 
 <para>
 This documentation set is constructed using several tools, including
-James Clark's <ulink url="http://www.jclark.com/jade/">
-<productname>jade</productname></ulink> and Norm Walsh's  <ulink
-url="http://www.berkshire.net/~norm/docbook/dsssl">Modular DocBook
-Stylesheets</ulink>.</para>
+James Clark's 
+<ulink url="http://www.jclark.com/jade/"> <productname>jade</productname></ulink>
+ and Norm Walsh's 
+<ulink url="http://www.berkshire.net/~norm/docbook/dsssl">Modular DocBook Stylesheets</ulink>.
 
 <para>
 Currently, hardcopy is produced by importing <firstterm>Rich Text
@@ -109,16 +650,16 @@ be included below.
 </thead>
 <tbody>
   <row>
-    <entry>Book</entry>
+    <entry><sgmltag>Book</sgmltag></entry>
     <entry>Delimits a Book element</entry>
   </row>
   <row>
-    <entry>Chapter</entry>
+    <entry><sgmltag>Chapter</sgmltag></entry>
     <entry>Delimits a Chapter element</entry>
   </row>
   <row>
-    <entry>Appendix</entry>
-    <entry>Delimits a Appendix element</entry>
+    <entry><sgmltag>Appendix</sgmltag></entry>
+    <entry><sgmltag>Delimits a Appendix element</sgmltag></entry>
   </row>
 </tbody>
 </tgroup>
@@ -853,3 +1394,4 @@ Run <productname>texhash</productname> to update the tex database.
 </para></sect2></sect1>
 
 </appendix>
+