docguide.sgml

关系型数据库 Postgresql 6.5.2

<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 parts.
Output is generated in <acronym>HTML</acronym> since the browser interface
makes it easy to move around all of the documentation by just clicking.
The other documents are available in both <acronym>HTML</acronym> and hardcopy.
</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>
</para>

<!--
Disable for the hardcopy production release.
Too much tabular info and not very helpful in hardcopy.
- thomas 1998-10-27
-->
</sect2>

<sect2>
<title>Documentation Files</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/about.sgml	</entry><entry>	New document </entry></row>
<row><entry> ./doc/src/sgml/admin.sgml	</entry><entry>	Administrator's Guide container	</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>	New document	</entry></row>
<row><entry> ./doc/src/sgml/bki.sgml	</entry><entry>	Converted from bki.5	</entry></row>
<row><entry> ./doc/src/sgml/compiler.sgml	</entry><entry>	New document	</entry></row>
<row><entry> ./doc/src/sgml/config.sgml	</entry><entry>	New document	</entry></row>
<row><entry> ./doc/src/sgml/contacts.sgml	</entry><entry>	Docs contributors? Not used. Either complete or discard	</entry></row>
<row><entry> ./doc/src/sgml/datatype.sgml	</entry><entry>	New document	</entry></row>
<row><entry> ./doc/src/sgml/dfunc.sgml	</entry><entry>	Converted	</entry></row>
<row><entry> ./doc/src/sgml/docguide.sgml	</entry><entry>	Documentation info. New document	</entry></row>
<row><entry> ./doc/src/sgml/ecpg.sgml	</entry><entry>	ecpg eSQL pre-compiler docs	</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>	GEQO genetic optimizer docs	</entry></row>
<row><entry> ./doc/src/sgml/gist.sgml	</entry><entry>	New from mailing list	</entry></row>
<row><entry> ./doc/src/sgml/history.sgml	</entry><entry>	New document	</entry></row>
<row><entry> ./doc/src/sgml/indices.sgml	</entry><entry>	New document	</entry></row>
<row><entry> ./doc/src/sgml/info.sgml	</entry><entry>	New document	</entry></row>
<row><entry> ./doc/src/sgml/inherit.sgml	</entry><entry>	Converted	</entry></row>
<row><entry> ./doc/src/sgml/install.sgml	</entry><entry>	Installation instructions	</entry></row>
<row><entry> ./doc/src/sgml/intro-ag.sgml	</entry><entry>	Admin Guide intro. Converted	</entry></row>
<row><entry> ./doc/src/sgml/intro-pg.sgml	</entry><entry>	Programmers Guide intro. Converted	</entry></row>
<row><entry> ./doc/src/sgml/intro.sgml	</entry><entry>	Users Guide intro	</entry></row>
<row><entry> ./doc/src/sgml/jdbc.sgml	</entry><entry>	New document from Peter Mount	</entry></row>
<row><entry> ./doc/src/sgml/keys.sgml	</entry><entry>	New document	</entry></row>
<row><entry> ./doc/src/sgml/legal.sgml	</entry><entry>	Copyright etc. for intros	</entry></row>
<row><entry> ./doc/src/sgml/libpgtcl.sgml	</entry><entry>	Converted	</entry></row>
<row><entry> ./doc/src/sgml/libpq++.sgml	</entry><entry>	C++ library. Converted	</entry></row>
<row><entry> ./doc/src/sgml/libpq.sgml	</entry><entry>	C library	</entry></row>
<row><entry> ./doc/src/sgml/lobj.sgml	</entry><entry>	Large objects	</entry></row>
<row><entry> ./doc/src/sgml/manage.sgml	</entry><entry>	Converted	</entry></row>
<row><entry> ./doc/src/sgml/notation.sgml	</entry><entry>	Docs notation for intros	</entry></row>
<row><entry> ./doc/src/sgml/odbc.sgml	</entry><entry>	ODBC driver	</entry></row>
<row><entry> ./doc/src/sgml/oper.sgml	</entry><entry>	Converted	</entry></row>
<row><entry> ./doc/src/sgml/page.sgml	</entry><entry>	On-disk storage scheme	</entry></row>
<row><entry> ./doc/src/sgml/pg_options.sgml	</entry><entry>	Backend configuration	</entry></row>
<row><entry> ./doc/src/sgml/pgaccess.sgml	</entry><entry>	Converted	</entry></row>
<row><entry> ./doc/src/sgml/ports.sgml	</entry><entry>	Supported/unsupported platforms	</entry></row>
<row><entry> ./doc/src/sgml/postgres.sgml	</entry><entry>	Container for all docs. Best for html output	</entry></row>
<row><entry> ./doc/src/sgml/programmer.sgml	</entry><entry>	Programmer's Guide	</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>	Database recovery	</entry></row>
<row><entry> ./doc/src/sgml/reference.sgml	</entry><entry>	Converted	</entry></row>
<row><entry> ./doc/src/sgml/regress.sgml	</entry><entry>	Regression testing	</entry></row>
<row><entry> ./doc/src/sgml/release.sgml	</entry><entry>	Converted	</entry></row>
<row><entry> ./doc/src/sgml/rules.sgml	</entry><entry>	Rule system	</entry></row>
<row><entry> ./doc/src/sgml/runtime.sgml	</entry><entry>	Runtime environment. New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/security.sgml	</entry><entry>	Server security	</entry></row>
<row><entry> ./doc/src/sgml/signals.sgml	</entry><entry>	System signals for backend. 	</entry></row>
<row><entry> ./doc/src/sgml/spi.sgml	</entry><entry>	Converted. Original removed	</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/syntax.sgml	</entry><entry>	SQL syntax. In UG	</entry></row>
<row><entry> ./doc/src/sgml/trigger.sgml	</entry><entry>	Converted	</entry></row>
<row><entry> ./doc/src/sgml/tutorial.sgml	</entry><entry>	Container for tutorial	</entry></row>
<row><entry> ./doc/src/sgml/typeconv.sgml	</entry><entry>	Datatype conversion. New for v6.4. In UG </entry></row>
<row><entry> ./doc/src/sgml/user.sgml	</entry><entry>	User's Guide	</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/xplang.sgml	</entry><entry>	Programming Language. New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/xtypes.sgml	</entry><entry>	Converted	</entry></row>
<row><entry> ./doc/src/sgml/y2k.sgml	</entry><entry>	Y2K statement. New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/abort.sgml	</entry><entry>	New for v6.4	</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 for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/alter_user.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/begin.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/close.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/cluster.sgml	</entry><entry>	New for v6.4	</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 for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/copy.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_aggregate.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_database.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_function.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_index.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_language.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_operator.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_rule.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_sequence.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_table.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_trigger.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_type.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_user.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/create_view.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/createdb.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/createuser.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/declare.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/delete.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/destroydb.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/destroyuser.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_aggregate.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_database.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_function.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_index.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_language.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_operator.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_rule.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_sequence.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_table.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_trigger.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_type.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_user.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/drop_view.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/explain.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/fetch.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/grant.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/initdb.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/initlocation.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/insert.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/listen.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/load.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/lock.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/move.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/notify.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/pg_dump.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/pg_dumpall.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/psql-ref.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/reset.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/revoke.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/rollback.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/select.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/set.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/show.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/update.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/vacuum.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/unlisten.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/vacuumdb.sgml	</entry><entry>	New for v6.4	</entry></row>
<row><entry> ./doc/src/sgml/ref/pg_upgrade.sgml	</entry><entry>	New for v6.4	</entry></row>
</tbody>
</tgroup>
</table>
</para>
</sect2>

<sect2>
<title>Document Conversion</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>	Obsolete. Converted to release.sgml		</entry></row>
<row><entry> ./README	</entry><entry>	Not converted	</entry></row>
<row><entry> ./INSTALL	</entry><entry>	Obsolete. Converted to install.sgml	</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>