Update/correct/refine.

diff --git a/doc/src/sgml/ref/pgtclsh.sgml b/doc/src/sgml/ref/pgtclsh.sgml
index c34da0ab8f7fe9e58a5860fdbb7be6e1be442141..39767128a22130fa3b3c6d80777e6b884cd2bce0 100644 (file)
--- a/doc/src/sgml/ref/pgtclsh.sgml
+++ b/doc/src/sgml/ref/pgtclsh.sgml
@@ -1,78 +1,74 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pgtclsh.sgml,v 1.2 2000/12/25 23:15:26 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pgtclsh.sgml,v 1.3 2001/03/06 17:43:56 petere Exp $
 Postgres documentation
 -->
 
 <refentry id="APP-PGTCLSH">
  <docinfo>
-  <date>2000-12-25</date>
+  <date>2001-03-05</date>
  </docinfo>
 
  <refmeta>
-  <refentrytitle id="app-pgtclsh-title">
-   <application>pgtclsh</application>
+  <refentrytitle>
+   pgtclsh
   </refentrytitle>
   <manvolnum>1</manvolnum>
   <refmiscinfo>Application</refmiscinfo>
  </refmeta>
+
  <refnamediv>
-  <refname>
-   <application>pgtclsh</application>
-  </refname>
+  <refname>pgtclsh</refname>
   <refpurpose>
-   <productname>Postgres</productname> TCL shell client
+   <productname>PostgreSQL</productname> <application>Tcl</application> shell client
   </refpurpose>
  </refnamediv>
+
  <refsynopsisdiv>
   <cmdsynopsis>
    <command>pgtclsh</command>
+   <arg><replaceable>filename</replaceable> <arg rep="repeat"><replaceable>arguments</replaceable></arg></arg>
   </cmdsynopsis>
-
-  <refsect2 id="R2-APP-PGTCLSH-1">
-   <title>
-    Inputs
-   </title>
-   <para>
-
-    <variablelist>
-     <varlistentry>
-      <term><replaceable class="PARAMETER">dbname</replaceable></term>
-      <listitem>
-       <para>
-       The name of an existing database to access.
-       </para>
-      </listitem>
-     </varlistentry>
-    </variablelist>
-   </para>
-  </refsect2>
-
-  <refsect2 id="R2-APP-PGTCLSH-2">
-   <title>
-    Outputs
-   </title>
-   <para>
-   </para>
-  </refsect2>
  </refsynopsisdiv>
 
- <refsect1 id="R1-APP-PGTCLSH-1">
+ <refsect1 id="app-pgtclsh-description">
   <title>
    Description
   </title>
+
   <para>
-   <application>pgtclsh</application> provides a TCL shell interface
-   for <productname>Postgres</productname>.
+   <command>pgtclsh</command> is a <application>Tcl</application>
+   shell interface extended with
+   <productname>Postgres</productname> database access functions.
+   (Essentially, it is <command>tclsh</command> with
+   <filename>libpgtcl</filename> loaded.)  Like with the regular
+   <application>Tcl</application> shell, the first command line
+   argument is a script file, any remaining arguments are passed to
+   the script.  If no script file is named, the shell is
+   interactive.
   </para>
 
   <para>
-   Another way of accessing <productname>Postgres</productname>
-   through tcl is to use
-   <xref linkend="app-pgtksh">
-   or
-   <xref linkend="app-pgaccess">.
+   A <application>Tcl</application> shell with
+   <application>Tk</application> and
+   <productname>Postgres</productname> functions is available as <xref
+   linkend="app-pgtksh">.
   </para>
  </refsect1>
+
+ <refsect1>
+  <title>See Also</title>
+
+  <simplelist type="inline">
+   <member><xref linkend="app-pgtksh"></member>
+   <member>
+    <citetitle>PostgreSQL Programmer's Guide</citetitle> (description of <filename>libpgtcl</filename>)
+   </member>
+   <member>
+    <citerefentry><refentrytitle>tclsh</refentrytitle> <manvolnum>1</manvolnum></citerefentry>
+   </member>
+  </simplelist>
+ </refsect1>
+
 </refentry>
 
 <!-- Keep this comment at the end of the file

diff --git a/doc/src/sgml/ref/pgtksh.sgml b/doc/src/sgml/ref/pgtksh.sgml
index a323bda7a29cdc0f7632cb0b6531f4244e39a189..a98564270593a54a5acc3f57224cf2a6ea40de9e 100644 (file)
--- a/doc/src/sgml/ref/pgtksh.sgml
+++ b/doc/src/sgml/ref/pgtksh.sgml
@@ -1,78 +1,77 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pgtksh.sgml,v 1.2 2000/12/25 23:15:26 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pgtksh.sgml,v 1.3 2001/03/06 17:43:56 petere Exp $
 Postgres documentation
 -->
 
 <refentry id="APP-PGTKSH">
  <docinfo>
-  <date>2000-12-25</date>
+  <date>2001-03-05</date>
  </docinfo>
 
  <refmeta>
-  <refentrytitle id="app-pgtksh-title">
-   <application>pgtksh</application>
+  <refentrytitle>
+   pgtksh
   </refentrytitle>
   <manvolnum>1</manvolnum>
   <refmiscinfo>Application</refmiscinfo>
  </refmeta>
+
  <refnamediv>
-  <refname>
-   <application>pgtksh</application>
-  </refname>
+  <refname>pgtksh</refname>
   <refpurpose>
-   <productname>Postgres</productname> graphical TCL/TK shell
+   <productname>PostgreSQL</productname> <application>Tcl/Tk</application> shell client
   </refpurpose>
  </refnamediv>
+
  <refsynopsisdiv>
   <cmdsynopsis>
    <command>pgtksh</command>
+   <arg><replaceable>filename</replaceable> <arg rep="repeat"><replaceable>arguments</replaceable></arg></arg>
   </cmdsynopsis>
-
-  <refsect2 id="R2-APP-PGTKSH-1">
-   <title>
-    Inputs
-   </title>
-   <para>
-
-    <variablelist>
-     <varlistentry>
-      <term><replaceable class="PARAMETER">dbname</replaceable></term>
-      <listitem>
-       <para>
-       The name of an existing database to access.
-       </para>
-      </listitem>
-     </varlistentry>
-    </variablelist>
-   </para>
-  </refsect2>
-
-  <refsect2 id="R2-APP-PGTKSH-2">
-   <title>
-    Outputs
-   </title>
-   <para>
-   </para>
-  </refsect2>
  </refsynopsisdiv>
 
- <refsect1 id="R1-APP-PGTKSH-1">
+ <refsect1 id="app-pgtksh-description">
   <title>
    Description
   </title>
+
   <para>
-   <application>pgtksh</application> provides a graphical TCL/TK shell interface
-   for <productname>Postgres</productname>.
+   <command>pgtksh</command> is a <application>Tcl/Tk</application>
+   shell interface extended with <productname>Postgres</productname>
+   database access functions.  (Essentially, it is
+   <command>wish</command> with <filename>libpgtcl</filename> loaded.)
+   Like with <command>wish</command>, the regular
+   <application>Tcl/Tk</application> shell, the first command line
+   argument is a script file, any remaining arguments are passed to
+   the script.  Special options may be processed by the
+   <application>X Window System</application> libraries instead.
+   If no script file is named, the shell is interactive.
   </para>
 
   <para>
-   Another way of accessing <productname>Postgres</productname>
-   through <acronym>TCL</acronym> is to use
-   <xref linkend="app-pgtclsh">
-   or
-   <xref linkend="app-pgaccess">.
+   A plain <application>Tcl</application> shell with
+   <productname>Postgres</productname> functions is available as <xref
+   linkend="app-pgtclsh">.
   </para>
  </refsect1>
+
+ <refsect1>
+  <title>See Also</title>
+
+  <simplelist type="inline">
+   <member><xref linkend="app-pgtclsh"></member>
+   <member>
+    <citetitle>PostgreSQL Programmer's Guide</citetitle> (description of <filename>libpgtcl</filename>)
+   </member>
+   <member>
+    <citerefentry><refentrytitle>tclsh</refentrytitle> <manvolnum>1</manvolnum></citerefentry>
+   </member>
+   <member>
+    <citerefentry><refentrytitle>wish</refentrytitle> <manvolnum>1</manvolnum></citerefentry>
+   </member>
+  </simplelist>
+ </refsect1>
+
 </refentry>
 
 <!-- Keep this comment at the end of the file