[PHP-DOC] cvs: phpdoc /en/functions pgsql.xml From: Egon Schmid (eschmid <email protected>)
Date: 07/22/00

eschmid Sat Jul 22 11:31:32 2000 EDT

  Modified files:
    /phpdoc/en/functions pgsql.xml
  Log:
  More cosmetic changes.
  
Index: phpdoc/en/functions/pgsql.xml
diff -u phpdoc/en/functions/pgsql.xml:1.11 phpdoc/en/functions/pgsql.xml:1.12
--- phpdoc/en/functions/pgsql.xml:1.11 Sat Jul 8 06:50:19 2000
+++ phpdoc/en/functions/pgsql.xml Sat Jul 22 11:31:32 2000
@@ -74,7 +74,6 @@
     with <command>commit</command> or <command>end</command>. If the
     transaction fails the transaction should be closed with
     <command>rollback</command> or <command>abort</command>.
-
     <example>
      <title>Using Large Objects</title>
      <programlisting role="php">
@@ -96,8 +95,8 @@
 
   <refentry id="function.pg-close">
    <refnamediv>
- <refname>pg_Close</refname>
- <refpurpose>closes a PostgreSQL connection</refpurpose>
+ <refname>pg_close</refname>
+ <refpurpose>Close a PostgreSQL connection</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -117,8 +116,8 @@
 
   <refentry id="function.pg-cmdtuples">
    <refnamediv>
- <refname>pg_cmdTuples</refname>
- <refpurpose>returns number of affected tuples</refpurpose>
+ <refname>pg_cmdtuples</refname>
+ <refpurpose>Returns number of affected tuples</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -129,15 +128,15 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_cmdTuples</function> returns the number of tuples
+ <function>Pg_cmdtuples</function> returns the number of tuples
      (instances) affected by INSERT, UPDATE, and DELETE queries. If no
      tuple is affected the function will return 0.
      <example>
- <title>pg_cmdtuples</title>
+ <title><function>Pg_cmdtuples</function></title>
       <programlisting role="php">
 &lt;?php
-$result = pg_exec($conn, "INSERT INTO verlag VALUES ('Autor')");
-$cmdtuples = pg_cmdtuples($result);
+$result = pg_exec ($conn, "INSERT INTO publisher VALUES ('Author')");
+$cmdtuples = pg_cmdtuples ($result);
 echo $cmdtuples . " &lt;- cmdtuples affected.";
 ?>
       </programlisting>
@@ -148,8 +147,8 @@
 
   <refentry id="function.pg-connect">
    <refnamediv>
- <refname>pg_Connect</refname>
- <refpurpose>opens a connection</refpurpose>
+ <refname>pg_connect</refname>
+ <refpurpose>Open a PostgreSQL connection</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -178,18 +177,18 @@
      Other parameters besides <parameter>dbname</parameter> and
      <parameter>port</parameter> are <parameter>host</parameter>,
      <parameter>tty</parameter>, <parameter>options</parameter>,
- <parameter>user</parameter> and <parameter>password</parameter>.
+ <parameter>user</parameter>, and <parameter>password</parameter>.
     </para>
     <para>
- See also <function>pg_pConnect</function>.
+ See also <function>pg_pconnect</function>.
     </para>
    </refsect1>
   </refentry>
 
   <refentry id="function.pg-dbname">
    <refnamediv>
- <refname>pg_DBname</refname>
- <refpurpose>database name</refpurpose>
+ <refname>pg_dbname</refname>
+ <refpurpose>Get the database name</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -209,8 +208,8 @@
 
   <refentry id="function.pg-errormessage">
    <refnamediv>
- <refname>pg_ErrorMessage</refname>
- <refpurpose>error message</refpurpose>
+ <refname>pg_errormessage</refname>
+ <refpurpose>Get the error message string</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -233,8 +232,8 @@
 
   <refentry id="function.pg-exec">
    <refnamediv>
- <refname>pg_Exec</refname>
- <refpurpose>execute a query</refpurpose>
+ <refname>pg_exec</refname>
+ <refpurpose>Execute a query</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -269,8 +268,8 @@
 
   <refentry id="function.pg-fetch-array">
    <refnamediv>
- <refname>pg_Fetch_Array</refname>
- <refpurpose>fetch row as array</refpurpose>
+ <refname>pg_fetch_array</refname>
+ <refpurpose>Fetch a row as an array</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -286,9 +285,10 @@
     </funcsynopsis>
     <para>
      Returns: An array that corresponds to the fetched row, or false
- if there are no more rows.</para>
+ if there are no more rows.
+ </para>
     <para>
- <function>pg_fetch_array</function> is an extended version of
+ <function>Pg_fetch_array</function> is an extended version of
      <function>pg_fetch_row</function>. In addition to storing the
      data in the numeric indices of the result array, it also stores
      the data in associative indices, using the field names as keys.
@@ -310,14 +310,14 @@
      provides a significant added value.
     </para>
     <para>
- For further details, also see
+ For further details, see also
      <function>pg_fetch_row</function>
     </para>
     <example>
      <title>PostgreSQL fetch array</title>
      <programlisting role="php">
 &lt;?php
-$conn = pg_pconnect("","","","","publisher");
+$conn = pg_pconnect ("", "", "", "", "publisher");
 if (!$conn) {
     echo "An error occured.\n";
     exit;
@@ -342,8 +342,8 @@
 
   <refentry id="function.pg-fetch-object">
    <refnamediv>
- <refname>pg_Fetch_Object</refname>
- <refpurpose>fetch row as object</refpurpose>
+ <refname>pg_fetch_object</refname>
+ <refpurpose>Fetch a row as an object</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -362,7 +362,7 @@
      row, or false if there are no more rows.
     </para>
     <para>
- <function>pg_fetch_object</function> is similar to
+ <function>Pg_fetch_object</function> is similar to
      <function>pg_fetch_array</function>, with one difference - an
      object is returned, instead of an array. Indirectly, that means
      that you can only access the data by the field names, and not by
@@ -435,8 +435,8 @@
 
   <refentry id="function.pg-fetch-row">
    <refnamediv>
- <refname>pg_Fetch_Row</refname>
- <refpurpose>get row as enumerated array</refpurpose>
+ <refname>pg_fetch_row</refname>
+ <refpurpose>Get a row as an enumerated array</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -452,7 +452,7 @@
      if there are no more rows.
     </para>
     <para>
- <function>pg_fetch_row</function> fetches one row of data from
+ <function>Pg_fetch_row</function> fetches one row of data from
      the result associated with the specified result identifier. The
      row is returned as an array. Each result column is stored in an
      array offset, starting at offset 0.
@@ -470,7 +470,7 @@
       <title>Postgres fetch row</title>
       <programlisting role="php">
 &lt;?php
-$conn = pg_pconnect("","","","","publisher");
+$conn = pg_pconnect ("", "", "", "", "publisher");
 if (!$conn) {
     echo "An error occured.\n";
     exit;
@@ -499,7 +499,7 @@
 
   <refentry id="function.pg-fieldisnull">
    <refnamediv>
- <refname>pg_FieldIsNull</refname>
+ <refname>pg_fieldisnull</refname>
     <refpurpose>Test if a field is NULL</refpurpose>
    </refnamediv>
    <refsect1>
@@ -523,7 +523,7 @@
 
   <refentry id="function.pg-fieldname">
    <refnamediv>
- <refname>pg_FieldName</refname>
+ <refname>pg_fieldname</refname>
     <refpurpose>Returns the name of a field</refpurpose>
    </refnamediv>
    <refsect1>
@@ -536,7 +536,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_FieldName</function> will return the name of the
+ <function>Pg_fieldname</function> will return the name of the
      field occupying the given column number in the given PostgreSQL
      result identifier. Field numbering starts from 0.
     </para>
@@ -545,8 +545,8 @@
 
   <refentry id="function.pg-fieldnum">
    <refnamediv>
- <refname>pg_FieldNum</refname>
- <refpurpose>Returns the number of a column</refpurpose>
+ <refname>pg_fieldnum</refname>
+ <refpurpose>Returns the field number of the named field</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -558,7 +558,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_FieldNum</function> will return the number of the
+ <function>Pg_fieldnum</function> will return the number of the
      column slot that corresponds to the named field in the given
      PosgreSQL result identifier. Field numbering starts at 0. This
      function will return -1 on error.
@@ -568,7 +568,7 @@
 
   <refentry id="function.pg-fieldprtlen">
    <refnamediv>
- <refname>pg_FieldPrtLen</refname>
+ <refname>pg_fieldprtlen</refname>
     <refpurpose>Returns the printed length</refpurpose>
    </refnamediv>
    <refsect1>
@@ -582,7 +582,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_FieldPrtLen</function> will return the actual
+ <function>Pg_fieldprtlen</function> will return the actual
      printed length (number of characters) of a specific value in a
      PostgreSQL result. Row numbering starts at 0. This function
      will return -1 on an error.
@@ -592,7 +592,7 @@
 
   <refentry id="function.pg-fieldsize">
    <refnamediv>
- <refname>pg_FieldSize</refname>
+ <refname>pg_fieldsize</refname>
     <refpurpose>
      Returns the internal storage size of the named field
     </refpurpose>
@@ -607,7 +607,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_FieldSize</function> will return the internal
+ <function>Pg_fieldsize</function> will return the internal
      storage size (in bytes) of the field number in the given
      PostgreSQL result. Field numbering starts at 0. A field size of
      -1 indicates a variable length field. This function will return
@@ -618,7 +618,7 @@
 
   <refentry id="function.pg-fieldtype">
    <refnamediv>
- <refname>pg_FieldType</refname>
+ <refname>pg_fieldtype</refname>
     <refpurpose>
      Returns the type name for the corresponding field number
     </refpurpose>
@@ -633,7 +633,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_FieldType</function> will return a string containing
+ <function>Pg_fieldtype</function> will return a string containing
      the type name of the given field in the given PostgreSQL result
      identifier. Field numbering starts at 0.
     </para>
@@ -642,8 +642,8 @@
 
   <refentry id="function.pg-freeresult">
    <refnamediv>
- <refname>pg_FreeResult</refname>
- <refpurpose>Frees up memory</refpurpose>
+ <refname>pg_freeresult</refname>
+ <refpurpose>Free reult memory</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -654,12 +654,12 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_FreeResult</function> only needs to be called if you
+ <function>Pg_freeresult</function> only needs to be called if you
      are worried about using too much memory while your script is
      running. All result memory will automatically be freed when the
      script is finished. But, if you are sure you are not going to
      need the result data anymore in a script, you may call
- <function>pg_FreeResult</function> with the result identifier as
+ <function>pg_freeresult</function> with the result identifier as
      an argument and the associated result memory will be freed.
     </para>
    </refsect1>
@@ -667,7 +667,7 @@
 
   <refentry id="function.pg-getlastoid">
    <refnamediv>
- <refname>pg_GetLastOid</refname>
+ <refname>pg_getlastoid</refname>
     <refpurpose>Returns the last object identifier</refpurpose>
    </refnamediv>
    <refsect1>
@@ -679,21 +679,24 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_GetLastOid</function> can be used to retrieve the
- Oid assigned to an inserted tuple if the result identifier is
- used from the last command sent via <function>pg_Exec</function>
- and was an SQL INSERT. This function will return a positive
- integer if there was a valid Oid. It will return -1 if an error
- occured or the last command sent via <function>pg_Exec</function>
- was not an INSERT.
+ <function>Pg_getlastoid</function> can be used to retrieve the
+ <varname>oid</varname> assigned to an inserted tuple if the
+ result identifier is used from the last command sent via
+ <function>pg_exec</function> and was an SQL INSERT. This
+ function will return a positive integer if there was a valid
+ <varname>oid</varname>. It will return -1 if an error occured or
+ the last command sent via <function>pg_exec</function> was not an
+ INSERT.
     </para>
    </refsect1>
   </refentry>
 
   <refentry id="function.pg-host">
    <refnamediv>
- <refname>pg_Host</refname>
- <refpurpose>Returns the host name</refpurpose>
+ <refname>pg_host</refname>
+ <refpurpose>
+ Returns the host name associated with the connection
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -704,7 +707,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_Host</function> will return the host name of the
+ <function>Pg_host</function> will return the host name of the
      given PostgreSQL connection identifier is connected to.
     </para>
    </refsect1>
@@ -713,7 +716,7 @@
   <refentry id="function.pg-loclose">
    <refnamediv>
     <refname>pg_loclose</refname>
- <refpurpose>close a large object</refpurpose>
+ <refpurpose>Close a large object</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -724,8 +727,8 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_loclose</function> closes an Inversion Large
- Object. <parameter>fd</parameter> is a file descriptor for the
+ <function>Pg_loclose</function> closes an Inversion Large
+ Object. <parameter>Fd</parameter> is a file descriptor for the
      large object from <function>pg_loopen</function>.
     </para>
    </refsect1>
@@ -734,7 +737,7 @@
   <refentry id="function.pg-locreate">
    <refnamediv>
     <refname>pg_locreate</refname>
- <refpurpose>create a large object</refpurpose>
+ <refpurpose>Create a large object</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -745,9 +748,9 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_locreate</function> creates an Inversion Large
- Object and returns the oid of the large object.
- <parameter>conn</parameter> specifies a valid database
+ <function>Pg_locreate</function> creates an Inversion Large
+ Object and returns the <varname>oid</varname> of the large
+ object. <parameter>conn</parameter> specifies a valid database
      connection. PostgreSQL access modes INV_READ, INV_WRITE, and
      INV_ARCHIVE are not supported, the object is created always with
      both read and write access. INV_ARCHIVE has been removed from
@@ -759,7 +762,7 @@
   <refentry id="function.pg-loexport">
    <refnamediv>
     <refname>pg_loexport</refname>
- <refpurpose>export a large object to file</refpurpose>
+ <refpurpose>Export a large object to file</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -779,10 +782,11 @@
     </funcsynopsis>
     <para>
      The <parameter>oid</parameter> argument specifies the object id
- of the large object to export and the <parameter>filename</parameter>
- argument specifies the pathname of the file. Returns FALSE if an error
- occurred, TRUE otherwise. Remember that handling large objects in
- PostgreSQL must happen inside a transaction.
+ of the large object to export and the
+ <parameter>filename</parameter> argument specifies the pathname
+ of the file. Returns FALSE if an error occurred, TRUE
+ otherwise. Remember that handling large objects in PostgreSQL
+ must happen inside a transaction.
     </para>
    </refsect1>
   </refentry>
@@ -790,7 +794,7 @@
   <refentry id="function.pg-loimport">
    <refnamediv>
     <refname>pg_loimport</refname>
- <refpurpose>import a large object from file</refpurpose>
+ <refpurpose>Import a large object from file</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -806,11 +810,11 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- The <parameter>filename</parameter> argument specifies the pathname
- of the file to be imported as a large object. Returns FALSE if an error
- occurred, object id of the just created large object otherwise. Remember
- that handling large objects in PostgreSQL must happen inside
- a transaction.
+ The <parameter>filename</parameter> argument specifies the
+ pathname of the file to be imported as a large object. Returns
+ FALSE if an error occurred, object id of the just created large
+ object otherwise. Remember that handling large objects in
+ PostgreSQL must happen inside a transaction.
     </para>
    </refsect1>
   </refentry>
@@ -818,7 +822,7 @@
   <refentry id="function.pg-loopen">
    <refnamediv>
     <refname>pg_loopen</refname>
- <refpurpose>open a large object</refpurpose>
+ <refpurpose>Open a large object</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -831,7 +835,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_loopen</function> open an Inversion Large Object and
+ <function>Pg_loopen</function> open an Inversion Large Object and
      returns file descriptor of the large object. The file descriptor
      encapsulates information about the connection. Do not close the
      connection before closing the large object file descriptor.
@@ -844,7 +848,7 @@
   <refentry id="function.pg-loread">
    <refnamediv>
     <refname>pg_loread</refname>
- <refpurpose>read a large object</refpurpose>
+ <refpurpose>Read a large object</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -869,7 +873,9 @@
   <refentry id="function.pg-loreadall">
    <refnamediv>
     <refname>pg_loreadall</refname>
- <refpurpose>read a entire large object</refpurpose>
+ <refpurpose>
+ Read a entire large object and send straight to browser
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -880,7 +886,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_loreadall</function> reads a large object and
+ <function>Pg_loreadall</function> reads a large object and
      passes it straight through to the browser after sending all pending
      headers. Mainly intended for sending binary data like images or sound.
     </para>
@@ -890,7 +896,7 @@
   <refentry id="function.pg-lounlink">
    <refnamediv>
     <refname>pg_lounlink</refname>
- <refpurpose>delete a large object</refpurpose>
+ <refpurpose>Delete a large object</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -902,7 +908,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_lounlink</function> deletes a large object with the
+ <function>Pg_lounlink</function> deletes a large object with the
      <parameter>lobjid</parameter> identifier for that large object.
     </para>
    </refsect1>
@@ -911,7 +917,7 @@
   <refentry id="function.pg-lowrite">
    <refnamediv>
     <refname>pg_lowrite</refname>
- <refpurpose>write a large object</refpurpose>
+ <refpurpose>Write a large object</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -923,7 +929,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_lowrite</function> writes at most to a large object
+ <function>Pg_lowrite</function> writes at most to a large object
      from a variable <parameter>buf</parameter> and returns the number
      of bytes actually written, or false in the case of an error.
      <parameter>fd</parameter> is a file descriptor for the large
@@ -934,7 +940,7 @@
 
   <refentry id="function.pg-numfields">
    <refnamediv>
- <refname>pg_NumFields</refname>
+ <refname>pg_numfields</refname>
     <refpurpose>Returns the number of fields</refpurpose>
    </refnamediv>
    <refsect1>
@@ -946,9 +952,9 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_NumFields</function> will return the number of
+ <function>Pg_numfields</function> will return the number of
      fields (columns) in a PostgreSQL result. The argument is a valid
- result identifier returned by <function>pg_Exec</function>. This
+ result identifier returned by <function>pg_exec</function>. This
      function will return -1 on error.
     </para>
    </refsect1>
@@ -956,7 +962,7 @@
 
   <refentry id="function.pg-numrows">
    <refnamediv>
- <refname>pg_NumRows</refname>
+ <refname>pg_numrows</refname>
     <refpurpose>Returns the number of rows</refpurpose>
    </refnamediv>
    <refsect1>
@@ -968,9 +974,9 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_NumRows</function> will return the number of rows in a
+ <function>Pg_numrows</function> will return the number of rows in a
      PostgreSQL result. The argument is a valid result identifier
- returned by <function>pg_Exec</function>. This function will
+ returned by <function>pg_exec</function>. This function will
      return -1 on error.
     </para>
    </refsect1>
@@ -978,8 +984,8 @@
 
   <refentry id="function.pg-options">
    <refnamediv>
- <refname>pg_Options</refname>
- <refpurpose>Returns options</refpurpose>
+ <refname>pg_options</refname>
+ <refpurpose>Get the options associated with the connection</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -990,7 +996,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_Options</function> will return a string containing
+ <function>Pg_options</function> will return a string containing
      the options specified on the given PostgreSQL connection
      identifier.
     </para>
@@ -999,9 +1005,9 @@
 
   <refentry id="function.pg-pconnect">
    <refnamediv>
- <refname>pg_pConnect</refname>
+ <refname>pg_pconnect</refname>
     <refpurpose>
- Make a persistent database connection
+ Open a persistent PostgreSQL connection
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1024,7 +1030,7 @@
      optional and can be left out. This function returns a connection
      index that is needed by other PostgreSQL functions. You can have
      multiple persistent connections open at once. See also
- <function>pg_Connect</function>.
+ <function>pg_connect</function>.
     </para>
     <para>
      A connection can also established with the following command:
@@ -1039,8 +1045,10 @@
 
   <refentry id="function.pg-port">
    <refnamediv>
- <refname>pg_Port</refname>
- <refpurpose>Returns the port number</refpurpose>
+ <refname>pg_port</refname>
+ <refpurpose>
+ Return the port number associated with the connection
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1051,7 +1059,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_Port</function> will return the port number that the
+ <function>Pg_port</function> will return the port number that the
      given PostgreSQL connection identifier is connected to.
     </para>
    </refsect1>
@@ -1059,7 +1067,7 @@
 
   <refentry id="function.pg-result">
    <refnamediv>
- <refname>pg_Result</refname>
+ <refname>pg_result</refname>
     <refpurpose>Returns values from a result identifier</refpurpose>
    </refnamediv>
    <refsect1>
@@ -1073,7 +1081,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_Result</function> will return values from a result
+ <function>Pg_result</function> will return values from a result
      identifier produced by <function>pg_Exec</function>. The
      <parameter>row_number</parameter> and
      <parameter>fieldname</parameter> sepcify what cell in the table
@@ -1096,7 +1104,7 @@
   <refentry id="function.pg-trace">
    <refnamediv>
     <refname>pg_trace</refname>
- <refpurpose>Trace a connection to PostgreSQL server</refpurpose>
+ <refpurpose>Enable tracing a PostgreSQL connection</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1116,25 +1124,27 @@
     </funcsynopsis>
     <para>
      Enables tracing of the PostgreSQL frontend/backend communication
- to a debugging file. To fully understand the results one needs to be
- familiar with the internals of PostgreSQL communication protocol.
- For those who are not, it can still be useful for tracing errors in
- queries sent to the server, you could do for example
- 'grep '^To backend' trace.log' and see what queriew actually were sent
- to the PostgreSQL server.
+ to a debugging file. To fully understand the results one needs to
+ be familiar with the internals of PostgreSQL communication
+ protocol. For those who are not, it can still be useful for
+ tracing errors in queries sent to the server, you could do for
+ example <command>grep '^To backend' trace.log</command> and see
+ what query actually were sent to the PostgreSQL server.
     </para>
     <para>
- <parameter>filename</parameter> and <parameter>mode</parameter> are the
- same as in <function>fopen</function> (<parameter>mode</parameter> defaults
- to 'w'), <parameter>connection</parameter> specifies the connection to
+ <parameter>Filename</parameter> and <parameter>mode</parameter>
+ are the same as in <function>fopen</function>
+ (<parameter>mode</parameter> defaults to 'w'),
+ <parameter>connection</parameter> specifies the connection to
      trace and defaults to the last one opened.
     </para>
     <para>
- Returns TRUE if <parameter>filename</parameter> could be opened for
- logging, FALSE otherwise.
+ Returns TRUE if <parameter>filename</parameter> could be opened
+ for logging, FALSE otherwise.
     </para>
     <para>
- See also <function>fopen</function> and <function>pg_untrace</function>.
+ See also <function>fopen</function> and
+ <function>pg_untrace</function>.
     </para>
    </refsect1>
   </refentry>
@@ -1142,7 +1152,9 @@
   <refentry id="function.pg-tty">
    <refnamediv>
     <refname>pg_tty</refname>
- <refpurpose>Returns the tty name</refpurpose>
+ <refpurpose>
+ Return the tty name associated with the connection
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1153,7 +1165,7 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>pg_tty</function> will return the tty name that server
+ <function>Pg_tty</function> will return the tty name that server
      side debugging output is sent to on the given PostgreSQL
      connection identifier.
     </para>
@@ -1163,7 +1175,7 @@
   <refentry id="function.pg-untrace">
    <refnamediv>
     <refname>pg_untrace</refname>
- <refpurpose>Stop tracing a connection to PostgreSQL server</refpurpose>
+ <refpurpose>Disable tracing of a PostgreSQL connection</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>