From a8cb3368db96d2492c3dce6ae2a3b7a69c11de90 Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <peter_e@gmx.net>
Date: Mon, 7 Apr 2003 01:29:26 +0000
Subject: General editing

---
 doc/src/sgml/pygresql.sgml | 49 +++++++++++++++++++++-------------------------
 1 file changed, 22 insertions(+), 27 deletions(-)

(limited to 'doc/src/sgml/pygresql.sgml')

diff --git a/doc/src/sgml/pygresql.sgml b/doc/src/sgml/pygresql.sgml
index 3b854d46735..391e8334eac 100644
--- a/doc/src/sgml/pygresql.sgml
+++ b/doc/src/sgml/pygresql.sgml
@@ -1,4 +1,4 @@
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/Attic/pygresql.sgml,v 1.9 2002/12/12 22:49:27 momjian Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/Attic/pygresql.sgml,v 1.10 2003/04/07 01:29:25 petere Exp $ -->
 
 <chapter id="pygresql">
  <title><application>PyGreSQL</application> - <application>Python</application> Interface</title>
@@ -334,13 +334,10 @@ make && make install
   <acronym>API</acronym> at <ulink
   url="http://www.python.org/topics/database/DatabaseAPI-2.0.html"
   >http://www.python.org/topics/database/DatabaseAPI-2.0.html</ulink>.
- </para>
-
- <para>
   A tutorial-like introduction to the <acronym>DB-API</acronym> can be
   found at <ulink
   url="http://www2.linuxjournal.com/lj-issues/issue49/2605.html"
-  >http://www2.linuxjournal.com/lj-issues/issue49/2605.html</ulink>
+  >http://www2.linuxjournal.com/lj-issues/issue49/2605.html</ulink>.
  </para>
 
  <sect1 id="pygresql-pg">
@@ -365,16 +362,15 @@ make && make install
 
     <listitem>
      <para>
-      <classname>pgqueryobject</classname> that handles query results.
+      <classname>pgqueryobject</classname>, which handles query results.
      </para>
     </listitem>
    </itemizedlist>
   </para>
 
   <para>
-   If you want to see a simple example of the use of some of these
-   functions, see <ulink url="http://www.druid.net/rides"
-   >http://www.druid.net/rides</ulink> where you can find a link at the
+   If you want to see a simple example of the use this module,
+   see <ulink url="http://www.druid.net/rides"></ulink> where you can find a link at the
    bottom to the actual <application>Python</application> code for the
    page.
   </para>
@@ -395,9 +391,9 @@ make && make install
       <term><varname>INV_WRITE</varname></term>
       <listitem>
        <para>
-        large objects access modes, used by
+        Large objects access modes, used by
         <function>(pgobject.)locreate</function> and
-        <function>(pglarge.)open</function>.
+        <function>(pglarge.)open</function>
        </para>
       </listitem>
      </varlistentry>
@@ -408,7 +404,7 @@ make && make install
       <term><varname>SEEK_END</varname></term>
       <listitem>
        <para>
-        positional flags, used by <function>(pglarge.)seek</function>.
+        Positional flags, used by <function>(pglarge.)seek</function>
        </para>
       </listitem>
      </varlistentry>
@@ -418,7 +414,7 @@ make && make install
       <term><varname>__version__</varname></term>
       <listitem>
        <para>
-        constants that give the current version
+        Constants that give the current version
        </para>
       </listitem>
      </varlistentry>
@@ -443,13 +439,13 @@ make && make install
    to handle general connection parameters without heavy code in your
    programs. You can prompt the user for a value, put it in the
    default variable, and forget it, without having to modify your
-   environment. The support for default variables can be disabled by
+   environment. The support for default variables can be disabled at build time by
    setting the <option>-DNO_DEF_VAR</option> option in the Python
    <filename>Setup</> file. Methods relative to this are specified by the tag [DV].
   </para>
 
   <para>
-   All variables are set to <symbol>None</symbol> at module
+   All default values are set to <symbol>None</symbol> at module
    initialization, specifying that standard environment variables
    should be used.
   </para>
@@ -478,7 +474,7 @@ connect(<optional><parameter>dbname</parameter></optional>, <optional><parameter
        <term><parameter>dbname</parameter></term>
 
        <listitem>
-        <para>Name of connected database (string/<symbol>None</>).</para>
+        <para>Name of connected database (string/<symbol>None</>)</para>
        </listitem>
       </varlistentry>
 
@@ -486,7 +482,7 @@ connect(<optional><parameter>dbname</parameter></optional>, <optional><parameter
        <term><parameter>host</parameter></term>
 
        <listitem>
-        <para>Name of the server host (string/<symbol>None</>).</para>
+        <para>Name of the server host (string/<symbol>None</>)</para>
        </listitem>
       </varlistentry>
 
@@ -494,7 +490,7 @@ connect(<optional><parameter>dbname</parameter></optional>, <optional><parameter
        <term><parameter>port</parameter></term>
 
        <listitem>
-        <para>Port used by the database server (integer/-1).</para>
+        <para>Port used by the database server (integer/-1)</para>
        </listitem>
       </varlistentry>
 
@@ -503,7 +499,7 @@ connect(<optional><parameter>dbname</parameter></optional>, <optional><parameter
 
        <listitem>
         <para>
-         Options for the server (string/<symbol>None</>).
+         Options for the server (string/<symbol>None</>)
         </para>
        </listitem>
       </varlistentry>
@@ -513,8 +509,8 @@ connect(<optional><parameter>dbname</parameter></optional>, <optional><parameter
 
        <listitem>
         <para>
-         File or tty for optional debug output from backend
-         (string/<symbol>None</>).
+         File or TTY for optional debug output from server
+         (string/<symbol>None</>)
         </para>
        </listitem>
       </varlistentry>
@@ -524,7 +520,7 @@ connect(<optional><parameter>dbname</parameter></optional>, <optional><parameter
 
        <listitem>
         <para>
-         <productname>PostgreSQL</productname> user (string/<symbol>None</>).
+         <productname>PostgreSQL</productname> user (string/<symbol>None</>)
         </para>
        </listitem>
       </varlistentry>
@@ -533,7 +529,7 @@ connect(<optional><parameter>dbname</parameter></optional>, <optional><parameter
        <term><parameter>passwd</parameter></term>
 
        <listitem>
-        <para>Password for user (string/<symbol>None</>).</para>
+        <para>Password for user (string/<symbol>None</>)</para>
        </listitem>
       </varlistentry>
      </variablelist>
@@ -601,12 +597,11 @@ connect(<optional><parameter>dbname</parameter></optional>, <optional><parameter
 
     <para>
      This method opens a connection to a specified database on a given
-     <productname>PostgreSQL</productname> server. You can use
-     key words here, as described in the
-     <application>Python</application> tutorial.  The names of the
+     <productname>PostgreSQL</productname> server. The arguments can be
+     given using key words here.  The names of the
      key words are the name of the parameters given in the syntax
      line. For a precise description of the parameters, please refer
-     to the <productname>PostgreSQL</productname> user manual.
+     to <xref linkend="libpq">.
     </para>
    </refsect1>
       
-- 
cgit v1.2.3