Fix collection of typos and grammar mistakes in the tree
authorMichael Paquier <michael@paquier.xyz>
Fri, 10 Apr 2020 02:18:39 +0000 (11:18 +0900)
committerMichael Paquier <michael@paquier.xyz>
Fri, 10 Apr 2020 02:18:39 +0000 (11:18 +0900)
This fixes some comments and documentation new as of Postgres 13.

Author: Justin Pryzby
Discussion: https://postgr.es/m/20200408165653.GF2228@telsasoft.com

doc/src/sgml/btree.sgml
doc/src/sgml/catalogs.sgml
doc/src/sgml/config.sgml
doc/src/sgml/func.sgml
doc/src/sgml/libpq.sgml
doc/src/sgml/ref/pg_validatebackup.sgml
src/backend/commands/tablecmds.c
src/backend/executor/execExpr.c
src/backend/postmaster/bgworker.c
src/backend/replication/basebackup.c
src/include/lib/simplehash.h

index f02e02b0acc270272acdc843a74b60b08a99a2b3..e9cab4a55dc6fcbb31b2b3d6249ace1a48d08f68 100644 (file)
@@ -685,7 +685,7 @@ equalimage(<replaceable>opcintype</replaceable> <type>oid</type>) returns bool
    Deduplication cannot be used in all cases due to
    implementation-level restrictions.  Deduplication safety is
    determined when <command>CREATE INDEX</command> or
-   <command>REINDEX</command> run.
+   <command>REINDEX</command> is run.
   </para>
   <para>
    Note that deduplication is deemed unsafe and cannot be used in the
index 386c6d7bd1b65b287d6c5d5036422c3ae9604cac..ce33df9e581963abcd47c546071699b4de954655 100644 (file)
@@ -6472,7 +6472,7 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</replaceable>:<replaceable>&l
        <xref linkend="sql-analyze"/>.
        A zero value indicates that no statistics should be collected.
        A negative value says to use the system default statistics target.
-       Positive values <structfield>stxstattarget</structfield>
+       Positive values of <structfield>stxstattarget</structfield>
        determine the target number of <quote>most common values</quote>
        to collect.
       </entry>
index a0da4aabac059b8f953201f9bc75bdb271b67ac5..a71ca624639422b04282dbf3428669be5a20900c 100644 (file)
        For example, <literal>30.1 GB</literal> will be converted
        to <literal>30822 MB</literal> not <literal>32319628902 B</literal>.
        If the parameter is of integer type, a final rounding to integer
-       occurs after any units conversion.
+       occurs after any unit conversion.
       </para>
      </listitem>
 
@@ -6110,8 +6110,8 @@ local0.*    /var/log/postgresql
          unoptimized queries in your applications.
          If this value is specified without units, it is taken as milliseconds.
          Setting this to zero prints all statement durations.
-         Minus-one (the default) disables logging statement durations.
-         Only superusers can change this setting.
+         <literal>-1</literal> (the default) disables logging statement
+         durations. Only superusers can change this setting.
         </para>
 
         <para>
@@ -6162,8 +6162,8 @@ local0.*    /var/log/postgresql
          traffic is too high to log all queries.
          If this value is specified without units, it is taken as milliseconds.
          Setting this to zero samples all statement durations.
-         Minus-one (the default) disables sampling statement durations.
-         Only superusers can change this setting.
+         <literal>-1</literal> (the default) disables sampling statement
+         durations. Only superusers can change this setting.
         </para>
 
         <para>
index a38387b8c60c3158014ac2dab38fb84da4474718..12d75b476f3ea31f6051f3f188bd98950f7fa066 100644 (file)
@@ -10006,7 +10006,7 @@ gen_random_uuid() returns uuid
    <title>Producing XML Content</title>
 
    <para>
-    A set of functions and function-like expressions are available for
+    A set of functions and function-like expressions is available for
     producing XML content from SQL data.  As such, they are
     particularly suitable for formatting query results into XML
     documents for processing in client applications.
@@ -12360,7 +12360,7 @@ table2-mapping
 
   <note>
    <para>
-    Some of the <literal>jsonb_path_*</literal> functions have the
+    Some of the <literal>jsonb_path_*</literal> functions have a
     <literal>_tz</literal> suffix. These functions have been implemented to
     support comparison of date/time values that involves implicit
     timezone-aware casts. Since operations with time zones are not immutable,
@@ -18795,8 +18795,8 @@ SELECT collation for ('foo' COLLATE "de_DE");
    The functions <function>to_regclass</function>, <function>to_regcollation</function>,
    <function>to_regnamespace</function>, <function>to_regoper</function>,
    <function>to_regoperator</function>, <function>to_regrole</function>,
-   <function>to_regproc</function>, <function>to_regprocedure</function>, and
-   <function>to_regtype</function>, functions translate relation, collation, schema,
+   <function>to_regproc</function>, <function>to_regprocedure</function> and
+   <function>to_regtype</function> translate relation, collation, schema,
    operator, role, function, and type names (given as <type>text</type>) to
    objects of the corresponding <type>reg*</type> type (see <xref
    linkend="datatype-oid"/> about the types).  These functions differ from a
index c2b3cdabad121ad1c057e89fb592d6baae482676..75d2224a61bfd45f054acfd57eae929e25270483 100644 (file)
@@ -797,7 +797,7 @@ void PQsetSSLKeyPassHook(PQsslKeyPassHook_type hook);
        its default <function>PQdefaultSSLKeyPassHook</function> handler. The callback
        should determine the password for the key and copy it to result-buffer
        <literal>buf</literal> of size <literal>size</literal>. The string in <literal>
-       buf</literal> must be null-terminated. The calback must return the length of
+       buf</literal> must be null-terminated. The callback must return the length of
        the password stored in <literal>buf</literal> excluding the null terminator.
        On failure, the callback should set <literal>buf[0] = '\0'</literal> and return 0.
        See <function>PQdefaultSSLKeyPassHook</function> in <literal>libpq</literal>'s
index 20d445efb8d8e4a52fb7ab0e6cb0679379943ace..5c626200f683e4afac3d9454449c7788bca649d6 100644 (file)
@@ -41,7 +41,7 @@ PostgreSQL documentation
   </para>
 
   <para>
-   It is important to note that that the validation which is performed by
+   It is important to note that the validation which is performed by
    <application>pg_validatebackup</application> does not and can not include
    every check which will be performed by a running server when attempting
    to make use of the backup. Even if you use this tool, you should still
@@ -73,7 +73,7 @@ PostgreSQL documentation
    a <literal>backup_manifest</literal> file in the target directory or
    about anything inside <literal>pg_wal</literal>, even though these
    files won't be listed in the backup manifest. Only files are checked;
-   the presence or absence or directories is not verified, except
+   the presence or absence of directories is not verified, except
    indirectly: if a directory is missing, any files it should have contained
    will necessarily also be missing. 
   </para>
index 6162fb018c72f212bd8495115f2e7778afffc837..037d457c3d469b873b45ae305080059fb31b8148 100644 (file)
@@ -16846,7 +16846,7 @@ ATExecDetachPartition(Relation rel, RangeVar *name)
    list_free_deep(fks);
 
    /*
-    * Any sub-constrains that are in the referenced-side of a larger
+    * Any sub-constraints that are in the referenced-side of a larger
     * constraint have to be removed.  This partition is no longer part of the
     * key space of the constraint.
     */
index 1370ffec5093536b6230cd8ea9505de04e610e0b..c6a77bd66fa529d5f873f0e458a90de8efe29b73 100644 (file)
@@ -2366,7 +2366,7 @@ get_last_attnums_walker(Node *node, LastAttnumInfo *info)
  * evaluation of the expression will have the same type of slot, with an
  * equivalent descriptor.
  *
- * Returns true if the the deforming step is required, false otherwise.
+ * Returns true if the deforming step is required, false otherwise.
  */
 static bool
 ExecComputeSlotInfo(ExprState *state, ExprEvalStep *op)
index 6c684b5e12b913bd488ae96540d4f6aec4a98054..beb5e85434cef6d876ab6b4c01a36a3a6e121a1a 100644 (file)
@@ -1149,7 +1149,7 @@ WaitForBackgroundWorkerShutdown(BackgroundWorkerHandle *handle)
  * Instruct the postmaster to terminate a background worker.
  *
  * Note that it's safe to do this without regard to whether the worker is
- * still running, or even if the worker may already have existed and been
+ * still running, or even if the worker may already have exited and been
  * unregistered.
  */
 void
index 50a9e9c28040fe76935b4a9525cd1b6656f15cf0..f5b2411d5495a6a3ce7fe6ee29cc770f5d2fe820 100644 (file)
@@ -1157,7 +1157,7 @@ AddFileToManifest(manifest_info *manifest, const char *spcoid,
    }
 
    /*
-    * Each file's entry need to be separated from any entry that follows by a
+    * Each file's entry needs to be separated from any entry that follows by a
     * comma, but there's no comma before the first one or after the last one.
     * To make that work, adding a file to the manifest starts by terminating
     * the most recently added line, with a comma if appropriate, but does not
index 8cb03cda6cc6ba52bfc14fa187bcb07c4934778b..f7af921f5aca8c8dbdfca1ccf28073d61c088d56 100644 (file)
@@ -633,7 +633,7 @@ restart:
            /* shift forward, starting at last occupied element */
 
            /*
-            * TODO: This could be optimized to be one memcpy in may cases,
+            * TODO: This could be optimized to be one memcpy in many cases,
             * excepting wrapping around at the end of ->data. Hasn't shown up
             * in profiles so far though.
             */