From 668c598a30f31ed4a250b27ef0180116d0d29d1a Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <peter_e@gmx.net>
Date: Tue, 6 Mar 2001 17:43:56 +0000
Subject: [PATCH] Update/correct/refine.
---
doc/src/sgml/ref/pgtclsh.sgml | 82 ++++++++++++++++-----------------
doc/src/sgml/ref/pgtksh.sgml | 85 +++++++++++++++++------------------
2 files changed, 81 insertions(+), 86 deletions(-)
diff --git a/doc/src/sgml/ref/pgtclsh.sgml b/doc/src/sgml/ref/pgtclsh.sgml
index c34da0ab8f7..39767128a22 100644
--- 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 a323bda7a29..a9856427059 100644
--- 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
--
GitLab