Include information on documentation products and sources.
Include tables of possible source files throughout tree.
This commit is contained in:
parent
bd6b6f40de
commit
3221c0de52
|
@ -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>
|
||||
|
||||
|
|
Loading…
Reference in New Issue