diff --git a/doc/src/sgml/ref/pgaccess-ref.sgml b/doc/src/sgml/ref/pgaccess-ref.sgml
index 1629ca7b9fb6e8f306aaaafb33328b8860e51166..7886a7070d737f2669972cec525fa21a0def31a9 100644
--- a/doc/src/sgml/ref/pgaccess-ref.sgml
+++ b/doc/src/sgml/ref/pgaccess-ref.sgml
@@ -1,58 +1,45 @@
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pgaccess-ref.sgml,v 1.6 2000/12/25 23:15:26 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pgaccess-ref.sgml,v 1.7 2000/12/30 17:11:32 petere Exp $
Postgres documentation
-->
<refentry id="APP-PGACCESS">
+ <docinfo>
+ <date>2000-12-30</date>
+ </docinfo>
+
<refmeta>
- <refentrytitle id="app-pgaccess-title">
- <application>pgaccess</application>
- </refentrytitle>
+ <refentrytitle id="app-pgaccess-title"><application>pgaccess</application></refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo>Application</refmiscinfo>
</refmeta>
+
<refnamediv>
- <refname>
- <application>pgaccess</application>
- </refname>
- <refpurpose>
- <productname>Postgres</productname> graphical interactive client
- </refpurpose>
+ <refname>pgaccess</refname>
+ <refpurpose><productname>PostgreSQL</productname> graphical client</refpurpose>
</refnamediv>
+
<refsynopsisdiv>
- <refsynopsisdivinfo>
- <date>1999-08-03</date>
- </refsynopsisdivinfo>
- <synopsis>
-pgaccess [ <replaceable class="parameter">dbname</replaceable> ]
- </synopsis>
-
- <refsect2 id="R2-APP-PGACCESS-1">
- <title>
- Inputs
- </title>
- <para>
-
- <variablelist>
- <varlistentry>
- <term><replaceable class="PARAMETER">dbname</replaceable></term>
- <listitem>
- <para>
+ <cmdsynopsis>
+ <command>pgaccess</command>
+ <arg><replaceable>dbname</replaceable></arg>
+ </cmdsynopsis>
+
+ <refsect2 id="app-pgaccess-options">
+ <title>Options</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><replaceable>dbname</replaceable></term>
+ <listitem>
+ <para>
The name of an existing database to access.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</refsect2>
- <refsect2 id="R2-APP-PGACCESS-2">
- <title>
- Outputs
- </title>
- <para>
- </para>
- </refsect2>
</refsynopsisdiv>
<refsect1 id="R1-APP-PGACCESS-1">
@@ -67,14 +54,6 @@ pgaccess [ <replaceable class="parameter">dbname</replaceable> ]
functions.
</para>
- <para>
- Another way of accessing <productname>Postgres</productname>
- through tcl is to use
- <xref linkend="app-pgtclsh">
- or
- <xref linkend="app-pgtksh">.
- </para>
-
<para>
<application>pgaccess</application> can:
@@ -82,7 +61,7 @@ pgaccess [ <replaceable class="parameter">dbname</replaceable> ]
<listitem>
<para>
Open any database on a specified host at the specified port,
- username and password.
+ username, and password.
</para>
</listitem>
@@ -94,7 +73,7 @@ pgaccess [ <replaceable class="parameter">dbname</replaceable> ]
<listitem>
<para>
- Save preferences in <filename>~/.pgaccessrc</filename> file.
+ Save preferences in the <filename>~/.pgaccessrc</filename> file.
</para>
</listitem>
</itemizedlist>
@@ -106,7 +85,7 @@ pgaccess [ <replaceable class="parameter">dbname</replaceable> ]
<itemizedlist mark="bullet" spacing="compact">
<listitem>
<para>
- Open multiple tables for viewing, max n records (configurable).
+ Open multiple tables for viewing, with a configurable number of rows shown.
</para>
</listitem>
@@ -136,13 +115,13 @@ pgaccess [ <replaceable class="parameter">dbname</replaceable> ]
<listitem>
<para>
- Import/export to external files (SDF,CSV).
+ Import/export to external files (<acronym>SDF</acronym>, <acronym>CSV</acronym>).
</para>
</listitem>
<listitem>
<para>
- Use filter capabilities; enter filter like price>3.14.
+ Use filter capabilities; enter filters like <literal>price > 3.14</literal>.
</para>
</listitem>
@@ -160,13 +139,13 @@ pgaccess [ <replaceable class="parameter">dbname</replaceable> ]
<listitem>
<para>
- Delete records; point to the record, press Del key.
+ Delete records; point to the record, press <keycap>Delete</keycap> key.
</para>
</listitem>
<listitem>
<para>
- Add new records; save new row with right-button-click.
+ Add new records; save new row with right-button click.
</para>
</listitem>
@@ -196,7 +175,7 @@ pgaccess [ <replaceable class="parameter">dbname</replaceable> ]
<itemizedlist mark="bullet" spacing="compact">
<listitem>
<para>
- Define, edit and store <firstterm>user defined queries</firstterm>.
+ Define, edit and store <firstterm>user-defined queries</firstterm>.
</para>
</listitem>
@@ -214,10 +193,10 @@ pgaccess [ <replaceable class="parameter">dbname</replaceable> ]
<listitem>
<para>
- Execute with optional user input parameters; e.g.,
- <programlisting>
+ Execute with optional user input parameters, e.g.,
+<programlisting>
select * from invoices where year=[parameter "Year of selection"]
- </programlisting>.
+</programlisting>
</para>
</listitem>
@@ -236,7 +215,7 @@ select * from invoices where year=[parameter "Year of selection"]
<listitem>
<para>
Construct queries using a visual query builder
- with drag & drop support, table aliasing.
+ with drag & drop support, table aliasing.
</para>
</listitem>
</itemizedlist>
@@ -332,7 +311,7 @@ select * from invoices where year=[parameter "Year of selection"]
<listitem>
<para>
- Change font, size and style of fields and labels.
+ Change font, size, and style of fields and labels.
</para>
</listitem>
@@ -344,7 +323,7 @@ select * from invoices where year=[parameter "Year of selection"]
<listitem>
<para>
- Preview tables, sample postscript print.
+ Preview tables, sample <productname>Postscript</productname> print.
</para>
</listitem>
</itemizedlist>
@@ -356,7 +335,7 @@ select * from invoices where year=[parameter "Year of selection"]
<itemizedlist mark="bullet" spacing="compact">
<listitem>
<para>
- Open user defined forms.
+ Open user-defined forms.
</para>
</listitem>
@@ -398,6 +377,42 @@ select * from invoices where year=[parameter "Year of selection"]
</itemizedlist>
</para>
</refsect1>
+
+ <refsect1>
+ <title>Diagnosistics</title>
+
+ <para>
+ If you get output like this:
+<screen>
+<computeroutput>
+Error in startup script: couldn't load file "libpgtcl.so": libpgtcl.so: cannot open shared object file: No such file or directory
+ while executing
+"load libpgtcl[info sharedlibextension]"
+ (procedure "main" line 3)
+ invoked from within
+"main $argc $argv"
+ (file "/usr/local/pgsql/share/pgaccess/main.tcl" line 249)
+</computeroutput>
+</screen>
+ then you need to configure your runtime linker to find the
+ <filename>libpgtcl.so</filename> library, most likely by setting
+ the <envar>LD_LIBRARY_PATH</envar> environment variable. Consult
+ the <productname>PostgreSQL</productname> installation instructions
+ for more information.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Notes</title>
+
+ <para>
+ <application>pgaccess</application> is written in Tcl/Tk. Your
+ <productname>PostgreSQL</productname> installation needs to be
+ build with Tcl support for <application>pgaccess</application> to
+ be available.
+ </para>
+ </refsect1>
+
</refentry>
<!-- Keep this comment at the end of the file