Add proofreader's changes to docs.

Fix misspelling of disbursion to dispersion.

Author: bmomjian

HISTORY

@@ -1652,7 +1652,7 @@ enclose unused functions in #ifdef NOT_USED(Bruce)
 Remove call to difftime() in timestamp support to fix SunOS(Bruce & Thomas)
 Changes for Digital Unix
 Portability fix for pg_dumpall(Bruce)
-Rename pg_attribute.attnvals to attdisbursion(Bruce)
+Rename pg_attribute.attnvals to attdispersion(Bruce)
 "intro/unix" manual page now "pgintro"(Bruce)
 "built-in" manual page now "pgbuiltin"(Bruce)
 "drop" manual page now "drop_table"(Bruce)

doc/TODO

@@ -250,7 +250,7 @@ MISC
 * allow configuration of maximum number of open files
 * Remove pg_listener index
 * Remove ANALYZE from VACUUM so it can be run separately without locks
-* Gather more accurate disbursion statistics using indexes
+* Gather more accurate dispersion statistics using indexes
 * Improve statistics storage in pg_class [performance]
 * Improve VACUUM speed with indexes [vacuum]
 * -BSD/OS does not support locale because there is no LC_MESSAGES (Bruce)

doc/TODO.detail/optimizer

@@ -518,7 +518,7 @@ cat << \SHAR_EOF > 'selfuncs.c.diff'
   		{
   			float32data nvals;
 
-  			nvals = getattdisbursion(relid, (int) attno);
+  			nvals = getattdispersion(relid, (int) attno);
 ! 			if (nvals == 0)
   				*result = 1.0 / 3.0;
   			else
@@ -534,7 +534,7 @@ cat << \SHAR_EOF > 'selfuncs.c.diff'
   		{
   			float32data nvals;
 
-  			nvals = getattdisbursion(relid, (int) attno);
+  			nvals = getattdispersion(relid, (int) attno);
 ! 			if (nvals == 0) {
   				*result = 1.0 / 3.0;
 + 			}
@@ -1059,7 +1059,7 @@ From owner-pgsql-hackers@hub.org Thu Jan 20 18:45:32 2000
 Received: from renoir.op.net (root@renoir.op.net [207.29.195.4])
 	by candle.pha.pa.us (8.9.0/8.9.0) with ESMTP id TAA00672
 	for <pgman@candle.pha.pa.us>; Thu, 20 Jan 2000 19:45:30 -0500 (EST)
-Received: from hub.org (hub.org [216.126.84.1]) by renoir.op.net (o1/$Revision: 1.14 $) with ESMTP id TAA01989 for <pgman@candle.pha.pa.us>; Thu, 20 Jan 2000 19:39:15 -0500 (EST)
+Received: from hub.org (hub.org [216.126.84.1]) by renoir.op.net (o1/$Revision: 1.15 $) with ESMTP id TAA01989 for <pgman@candle.pha.pa.us>; Thu, 20 Jan 2000 19:39:15 -0500 (EST)
 Received: from localhost (majordom@localhost)
 	by hub.org (8.9.3/8.9.3) with SMTP id TAA00957;
 	Thu, 20 Jan 2000 19:35:19 -0500 (EST)

doc/src/sgml/Makefile

@@ -8,7 +8,7 @@
 #
 #
 # IDENTIFICATION
-#    $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.21 2000/10/05 16:57:23 petere Exp $
+#    $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.22 2000/10/05 19:48:16 momjian Exp $
 #
 #----------------------------------------------------------------------------
 
@@ -79,7 +79,7 @@ APPLICATIONS= createdb.sgml createlang.sgml createuser.sgml \
 	pgaccess-ref.sgml \
 	pgadmin-ref.sgml \
 	pg-config-ref.sgml \
-	pgctl-ref.sgml \
+	pg_ctl-ref.sgml \
 	pgtclsh.sgml \
 	pgtksh.sgml \
 	postgres-ref.sgml \

doc/src/sgml/ref/allfiles.sgml

@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.21 2000/08/26 13:08:15 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/allfiles.sgml,v 1.22 2000/10/05 19:48:17 momjian Exp $
 Postgres documentation
 Complete list of usable sgml source files in this directory.
 -->
@@ -121,7 +121,7 @@ Complete list of usable sgml source files in this directory.
 <!entity pgAccess           system "pgaccess-ref.sgml">
 <!entity pgAdmin            system "pgadmin-ref.sgml">
 <!entity pgConfig           system "pg-config-ref.sgml">
-<!entity pgCtl              system "pgctl-ref.sgml">
+<!entity pgCtl              system "pg_ctl-ref.sgml">
 <!entity pgDump             system "pg_dump.sgml">
 <!entity pgDumpall          system "pg_dumpall.sgml">
 <!entity pgPasswd           system "pg_passwd.sgml">

doc/src/sgml/ref/alter_table.sgml

@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.14 2000/07/22 02:39:10 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.15 2000/10/05 19:48:17 momjian Exp $
 Postgres documentation
 -->
 
@@ -273,7 +273,7 @@ ALTER TABLE <replaceable class="PARAMETER">table</replaceable> DROP CONSTRAINT <
       <para>
        Removes a table constraint (such as a check constraint,
        unique constraint, or foreign key constraint). To 
-       remove a unique constraint, drop a unique index,
+       remove a unique constraint, drop a unique index.
        To remove other kinds of constraints you need to recreate
        and reload the table, using other parameters to the
        <xref linkend="SQL-CREATETABLE" endterm="SQL-CREATETABLE-title">

doc/src/sgml/ref/copy.sgml

@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/copy.sgml,v 1.17 2000/07/22 02:39:10 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/copy.sgml,v 1.18 2000/10/05 19:48:17 momjian Exp $
 Postgres documentation
 -->
 
@@ -210,7 +210,7 @@ ERROR: <replaceable>reason</replaceable>
     You must have <firstterm>select access</firstterm> on any table
     whose values are read by
     <command>COPY</command>, and either
-    <firstterm>insert or update access</firstterm> to a
+    <firstterm>insert</firstterm> or <firstterm>update access</firstterm> to a
     table into which values are being inserted by <command>COPY</command>.
     The backend also needs appropriate Unix permissions for any file read
     or written by <command>COPY</command>.
@@ -293,7 +293,7 @@ ERROR: <replaceable>reason</replaceable>
    <para>
     The actual format for each instance is
     <programlisting>
-&lt;attr1&gt;&lt;<replaceable class=parameter>separator</replaceable>&gt;&lt;attr2&gt;&lt;<replaceable class=parameter>separator</replaceable>&gt;...&lt;<replaceable class=parameter>separator</replaceable>&gt;&lt;attr<replaceable class="parameter">n</replaceable>&gt;&lt;newline&gt;
+&lt;attr1&gt;&lt;<replaceable class=parameter>separator</replaceable>&gt;&lt;attr2&gt;&lt;<replaceable class=parameter>separator</replaceable>&gt;...&lt;<replaceable class=parameter>separator</replaceable>&gt;&lt;attr<replaceable class="parameter">n</replaceable>&gt;&lt;newline&gt;.
     </programlisting>
     The oid is placed on the beginning of the line
     if WITH OIDS is specified.
@@ -331,7 +331,7 @@ ERROR: <replaceable>reason</replaceable>
     In the case of <command>COPY BINARY</command>, the first four
     bytes in the file will be the number of instances in the file.  If
     this number is zero, the <command>COPY BINARY</command> command
-    will read until end of file is encountered.  Otherwise, it will
+    will read until end-of-file is encountered.  Otherwise, it will
     stop reading when this number of instances has been read.
     Remaining data in the file will be ignored.
    </para>
@@ -414,7 +414,7 @@ The following example copies a table to standard output,
 COPY country TO <filename>stdout</filename> USING DELIMITERS '|';
   </programlisting>
   <para>
-   To copy data from a Unix file into a table "country":
+   To copy data from a Unix file into a table country:
   </para>
   <programlisting>
 COPY country FROM '/usr1/proj/bray/sql/country_data';
@@ -434,7 +434,7 @@ has the termination sequence on the last line):
    \.
   </programlisting>
   <para>
-   The same data, output in binary format on a Linux/i586 machine.
+   The following is the same data, output in binary format on a Linux/i586 machine.
    The data is shown after filtering through
  the Unix utility <command>od -c</command>. The table has
    three fields; the first is <classname>char(2)</classname>

doc/src/sgml/ref/create_aggregate.sgml

@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_aggregate.sgml,v 1.11 2000/09/12 20:52:07 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_aggregate.sgml,v 1.12 2000/10/05 19:48:17 momjian Exp $
 Postgres documentation
 -->
 
@@ -162,7 +162,7 @@ CREATE
    for base types such as <function>min(int4)</function>
    and <function>avg(float8)</function> are already provided in the base
    distribution. If one defines new types or needs an aggregate function not
-   already provided then <command>CREATE AGGREGATE</command>
+   already provided, then <command>CREATE AGGREGATE</command>
    can be used to provide the desired features.
   </para>
   <para>

doc/src/sgml/ref/create_database.sgml

@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_database.sgml,v 1.14 2000/05/02 20:02:03 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_database.sgml,v 1.15 2000/10/05 19:48:17 momjian Exp $
 Postgres documentation
 -->
 
@@ -115,7 +115,7 @@ CREATE DATABASE <replaceable class="PARAMETER">name</replaceable> [ WITH LOCATIO
       <listitem>
        <para>
         The expansion of the specified <replaceable class="parameter">dbpath</replaceable>
-        (see below how) failed. Check the path you entered or make sure that the
+        (see below) failed. Check the path you entered or make sure that the
         environment variable you are referencing does exist.
        </para>
       </listitem>
@@ -138,7 +138,7 @@ CREATE DATABASE <replaceable class="PARAMETER">name</replaceable> [ WITH LOCATIO
        <para>
         These are most likely related to insufficient permissions on the data
         directory, a full disk, or other file system problems. The user under
-        which the database server is running, must have access to the location.
+        which the database server is running must have access to the location.
        </para>
       </listitem>
      </varlistentry>
@@ -177,7 +177,7 @@ CREATE DATABASE <replaceable class="PARAMETER">name</replaceable> [ WITH LOCATIO
    If the server is compiled with <literal>ALLOW_ABSOLUTE_DBPATHS</literal>
    (not so by default), absolute path names, as identified by
    a leading slash
-   (e.g. '<filename>/usr/local/pgsql/data</filename>'),
+   (e.g., '<filename>/usr/local/pgsql/data</filename>'),
    are allowed as well.
   </para>
 

doc/src/sgml/ref/create_function.sgml

@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.17 2000/08/25 15:17:50 thomas Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_function.sgml,v 1.18 2000/10/05 19:48:17 momjian Exp $
 Postgres documentation
 -->
 
@@ -60,7 +60,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab
 	The data type(s) of the function's arguments, if any.
 	The input types may be base or complex types, or
 	<firstterm>opaque</firstterm>.
-	<literal>opaque</literal> indicates that the function
+	<literal>Opaque</literal> indicates that the function
 	accepts arguments of a non-SQL type such as <type>char *</type>.
        </para>
       </listitem>
@@ -71,7 +71,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab
        <para>
 	The return data type.
 	The output type may be specified as a base type, complex type, 
-	<option>setof <replaceable class="parameter">type</replaceable></option>,
+	<option>setof type</option>,
 	or <option>opaque</option>.
 	The <option>setof</option>
 	modifier indicates that the function will return a set of items,
@@ -103,7 +103,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab
       <listitem>
        <para>
 	This form of the <command>AS</command> clause is used for
-	dynamically-linked, C language functions when the function name in
+	dynamically linked, C language functions when the function name in
 	the C language source code is not the same as the name of the SQL
 	function. The string <replaceable
 	class="parameter">obj_file</replaceable> is the name of the file
@@ -118,7 +118,7 @@ CREATE FUNCTION <replaceable class="parameter">name</replaceable> ( [ <replaceab
       <term><replaceable class="parameter">langname</replaceable></term>
       <listitem>
        <para>
-	may be '<literal>sql</literal>',
+	May be '<literal>sql</literal>',
 	'<literal>C</literal>', '<literal>newC</literal>',
 	'<literal>internal</literal>', '<literal>newinternal</literal>',
 	or '<replaceable class="parameter">plname</replaceable>',
@@ -189,7 +189,7 @@ CREATE
       <term>iscachable</term>
       <listitem>
        <para>
-	<option>iscachable</option> indicates that the function always
+	<option>Iscachable</option> indicates that the function always
 	returns the same result when given the same argument values (i.e.,
 	it does not do database lookups or otherwise use information not
 	directly present in its parameter list).  The optimizer uses
@@ -243,7 +243,7 @@ CREATE
    <para>
     The full <acronym>SQL92</acronym> type syntax is allowed for
     input arguments and return value. However, some details of the
-    type specification (e.g. the precision field for
+    type specification (e.g., the precision field for
     <type>numeric</type> types) are the responsibility of the
     underlying function implementation and are silently swallowed
     (i.e., not recognized or
@@ -263,7 +263,7 @@ CREATE
     errors at link time.  To get around that, give them different C names
     (for example, use the argument types as part of the C names), then
     specify those names in the AS clause of <command>CREATE FUNCTION</command>.
-    If the AS clause is left empty then <command>CREATE FUNCTION</command>
+    If the AS clause is left empty, then <command>CREATE FUNCTION</command>
     assumes the C name of the function is the same as the SQL name.
    </para>
 
@@ -322,7 +322,7 @@ CREATE TABLE product (
 
   <para>
    This example creates a function that does type conversion between the
-   user defined type complex, and the internal type point.  The
+   user-defined type complex, and the internal type point.  The
    function is implemented by a dynamically loaded object that was
    compiled from C source. For <productname>Postgres</productname> to
    find a type conversion function automatically, the sql function has

doc/src/sgml/ref/create_index.sgml

@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_index.sgml,v 1.15 2000/09/12 20:52:08 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_index.sgml,v 1.16 2000/10/05 19:48:17 momjian Exp $
 Postgres documentation
 -->
 
@@ -305,7 +305,7 @@ ERROR: Cannot create index: 'index_name' already exists.
       <literal>bigbox_ops</literal> both support rtree indices on the
       <literal>box</literal> data type.
       The difference between them is that <literal>bigbox_ops</literal>
-      scales box coordinates down, to avoid floating point exceptions from
+      scales box coordinates down, to avoid floating-point exceptions from
       doing multiplication, addition, and subtraction on very large
       floating-point coordinates.  If the field on which your rectangles lie
       is about 20,000 units square or larger, you should use

doc/src/sgml/ref/create_language.sgml

@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_language.sgml,v 1.11 2000/08/24 23:36:29 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_language.sgml,v 1.12 2000/10/05 19:48:17 momjian Exp $
 Postgres documentation
 -->
 
@@ -169,7 +169,7 @@ ERROR:  PL handler function <replaceable class="parameter">funcname</replaceable
 
    <para>
     The call handler for a procedural language must be written
-    in a compiled language such as 'C' and registered with
+    in a compiled language such as C and registered with
     <productname>Postgres</productname> as a function taking
     no arguments and returning the
     <type>opaque</type> type, a placeholder for unspecified or undefined types.
@@ -206,7 +206,7 @@ ERROR:  PL handler function <replaceable class="parameter">funcname</replaceable
     <filename>pg_proc</filename> table entry. This may be the
     source text in the procedural
     language itself (like for PL/Tcl), a pathname to a
-    file or anything else that tells the call handler what to
+    file, or anything else that tells the call handler what to
     do in detail.
    </para>
 
@@ -295,7 +295,7 @@ ERROR:  PL handler function <replaceable class="parameter">funcname</replaceable
    Usage
   </title>
   <para>
-   This is a template for a PL handler written in 'C':
+   This is a template for a PL handler written in C:
    <programlisting>
 #include "executor/spi.h"
 #include "commands/trigger.h"

doc/src/sgml/ref/create_rule.sgml

@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_rule.sgml,v 1.18 2000/07/22 02:39:10 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_rule.sgml,v 1.19 2000/10/05 19:48:17 momjian Exp $
 Postgres documentation
 -->
 
@@ -71,7 +71,7 @@ CREATE RULE <replaceable class="parameter">name</replaceable> AS ON <replaceable
       <listitem>
        <para>
 	Any SQL WHERE clause, <literal>new</literal> or
-	<literal>old</literal> can appear instead of an instance
+	<literal>old</literal>, can appear instead of an instance
 	variable whenever an instance variable is permissible in SQL.
        </para>
       </listitem>
@@ -81,7 +81,7 @@ CREATE RULE <replaceable class="parameter">name</replaceable> AS ON <replaceable
       <listitem>
        <para>
 	Any SQL statement, <literal>new</literal> or
-	<literal>old</literal> can appear instead of an instance
+	<literal>old</literal>, can appear instead of an instance
 	variable whenever an instance variable is permissible in SQL.
        </para>
       </listitem>
@@ -133,7 +133,7 @@ CREATE
 
   <para>
    The semantics of a rule is that at the time an individual instance is
-   accessed, inserted, updated, or deleted, there is a old instance (for
+   accessed, inserted, updated, or deleted, there is an old instance (for
    selects, updates and deletes) and a new instance (for inserts and
   updates).
   If the <replaceable class="parameter">event</replaceable>
@@ -190,7 +190,7 @@ ON UPDATE TO emp-1.salary WHERE emp-2.name = "Joe"
     <replaceable class="parameter">condition</replaceable> part of the rule
     occurs. Alternately, the
     <replaceable class="parameter">action</replaceable> part will be done
-    instead of the user command. In this later case, the
+    instead of the user command. In this latter case, the
     <replaceable class="parameter">action</replaceable> can be the keyword
     <literal>NOTHING</literal>.
    </para>

doc/src/sgml/ref/create_sequence.sgml

@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_sequence.sgml,v 1.13 2000/07/21 04:25:05 momjian Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/create_sequence.sgml,v 1.14 2000/10/05 19:48:17 momjian Exp $
 Postgres documentation
 -->
 
@@ -109,7 +109,7 @@ CREATE SEQUENCE <replaceable class="parameter">seqname</replaceable> [ INCREMENT
 	The <option>CACHE <replaceable class="parameter">cache</replaceable></option> option
 	enables sequence numbers to be preallocated
 	and stored in memory for faster access. The  minimum
-	value is 1 (only one value can be generated at a time, i.e. no cache)
+	value is 1 (only one value can be generated at a time, i.e., no cache)
 	and this is also the default.
        </para>
       </listitem>