Fix some grammar and typos in comments and docs
authorMichael Paquier <michael@paquier.xyz>
Mon, 2 Nov 2020 06:14:41 +0000 (15:14 +0900)
committerMichael Paquier <michael@paquier.xyz>
Mon, 2 Nov 2020 06:14:41 +0000 (15:14 +0900)
The documentation fixes are backpatched down to where they apply.

Author: Justin Pryzby
Discussion: https://postgr.es/m/20201031020801.GD3080@telsasoft.com
Backpatch-through: 9.6

25 files changed:
contrib/amcheck/verify_heapam.c
contrib/pgcrypto/pgp-compress.c
doc/src/sgml/auto-explain.sgml
doc/src/sgml/ddl.sgml
doc/src/sgml/ref/pg_rewind.sgml
src/backend/access/heap/pruneheap.c
src/backend/catalog/namespace.c
src/backend/catalog/pg_namespace.c
src/backend/commands/copy.c
src/backend/commands/tablecmds.c
src/backend/executor/execExpr.c
src/backend/executor/nodeIncrementalSort.c
src/backend/executor/nodeLimit.c
src/backend/optimizer/path/allpaths.c
src/backend/optimizer/plan/analyzejoins.c
src/backend/partitioning/partbounds.c
src/backend/postmaster/interrupt.c
src/backend/statistics/dependencies.c
src/backend/statistics/extended_stats.c
src/backend/storage/buffer/bufmgr.c
src/backend/utils/adt/varlena.c
src/bin/pg_rewind/parsexlog.c
src/bin/pgbench/pgbench.c
src/interfaces/libpq/fe-connect.c
src/test/modules/dummy_index_am/dummy_index_am.c

index 8bb890438aa9577cc3b73c3de550da75dd3931b7..570f44b59ee12a5bbac060f566b80db1258daa8a 100644 (file)
@@ -560,7 +560,7 @@ verify_heapam_tupdesc(void)
  * Since we do not hold a snapshot, tuple visibility is not a question of
  * whether we should be able to see the tuple relative to any particular
  * snapshot, but rather a question of whether it is safe and reasonable to
- * to check the tuple attributes.
+ * check the tuple attributes.
  *
  * Some kinds of corruption make it unsafe to check the tuple attributes, for
  * example when the line pointer refers to a range of bytes outside the page.
@@ -1342,7 +1342,7 @@ fxid_in_cached_range(FullTransactionId fxid, const HeapCheckContext *ctx)
 }
 
 /*
- * Checks wheter a multitransaction ID is in the cached valid range, returning
+ * Checks whether a multitransaction ID is in the cached valid range, returning
  * the nature of the range violation, if any.
  */
 static XidBoundsViolation
index 7e8ddba187351b6cecea85b2752acb038d99fbd1..086bec31ae2ccfcfb9aee0bdfa4d1fff04227d05 100644 (file)
@@ -291,7 +291,7 @@ restart:
         * A stream must be terminated by a normal packet.  If the last stream
         * packet in the source stream is a full packet, a normal empty packet
         * must follow.  Since the underlying packet reader doesn't know that
-        * the compressed stream has been ended, we need to to consume the
+        * the compressed stream has been ended, we need to consume the
         * terminating packet here.  This read does not harm even if the
         * stream has already ended.
         */
index 192d6574c30cc94b326aec3fcbcf08bf3f0f9e14..30e35a714a5f6c92d46cc72803d179f54f1104b8 100644 (file)
@@ -200,7 +200,7 @@ LOAD 'auto_explain';
     <listitem>
      <para>
       <varname>auto_explain.log_settings</varname> controls whether information
-      about modified configuration options is printed when execution plan is logged.
+      about modified configuration options is printed when an execution plan is logged.
       Only options affecting query planning with value different from the built-in
       default value are included in the output.  This parameter is off by default.
       Only superusers can change this setting.
index c4897d68c9b9eb93e7759b06cf23d8161954e5d5..872f7a7fac27ee83ff90796079430e8c9d96262a 100644 (file)
@@ -3919,7 +3919,7 @@ CREATE INDEX ON measurement (logdate);
 
     <para>
       Normally the set of partitions established when initially defining the
-      table are not intended to remain static.  It is common to want to
+      table is not intended to remain static.  It is common to want to
       remove old partitions of data and periodically add new partitions for
       new data. One of the most important advantages of partitioning is
       precisely that it allows this otherwise painful task to be executed
index 688acdcb06af845ccb66e07f65a8f1e91c5b3771..43282e6016fb11213481ee6b1c3d84ab2c345d4e 100644 (file)
@@ -74,7 +74,7 @@ PostgreSQL documentation
    <application>pg_rewind</application> with the <literal>-c</literal> option to
    automatically retrieve them from the WAL archive. The use of
    <application>pg_rewind</application> is not limited to failover, e.g.,  a standby
-   server can be promoted, run some write transactions, and then rewinded
+   server can be promoted, run some write transactions, and then rewound
    to become a standby again.
   </para>
 
index bc510e2e9b36cef5ab857d119f053ca7dd36dfde..9e04bc712c94fccef4136e3ae4d64f79db5804f5 100644 (file)
@@ -385,7 +385,7 @@ heap_page_prune(Relation relation, Buffer buffer,
 
 
 /*
- * Perform visiblity checks for heap pruning.
+ * Perform visibility checks for heap pruning.
  *
  * This is more complicated than just using GlobalVisTestIsRemovableXid()
  * because of old_snapshot_threshold. We only want to increase the threshold
index 391a9b225db796ffbe9cc1a48d5d45640313eb5d..740570c566dd32c3eec31d08a99a3f223aceba9f 100644 (file)
@@ -3853,7 +3853,7 @@ recomputeNamespacePath(void)
    /*
     * We want to detect the case where the effective value of the base search
     * path variables didn't change.  As long as we're doing so, we can avoid
-    * copying the OID list unncessarily.
+    * copying the OID list unnecessarily.
     */
    if (baseCreationNamespace == firstNS &&
        baseTempCreationPending == temp_missing &&
index ed8527607057c52ce8e55373be8593e5960d19e2..7d2e26fd359b374a810a7c72b0d3d1e75eb2ac51 100644 (file)
@@ -106,7 +106,7 @@ NamespaceCreate(const char *nspName, Oid ownerId, bool isTemp)
    /* dependency on owner */
    recordDependencyOnOwner(NamespaceRelationId, nspoid, ownerId);
 
-   /* dependences on roles mentioned in default ACL */
+   /* dependencies on roles mentioned in default ACL */
    recordDependencyOnNewAcl(NamespaceRelationId, nspoid, 0, ownerId, nspacl);
 
    /* dependency on extension ... but not for magic temp schemas */
index 36ddcdccdb837564e0e7fc2ee108588c6c3cef29..115860a9d403b1d46e5129401f6bf53546f968b7 100644 (file)
@@ -2610,9 +2610,9 @@ CopyMultiInsertInfoFlush(CopyMultiInsertInfo *miinfo, ResultRelInfo *curr_rri)
 
    /*
     * Trim the list of tracked buffers down if it exceeds the limit.  Here we
-    * remove buffers starting with the ones we created first.  It seems more
-    * likely that these older ones are less likely to be needed than ones
-    * that were just created.
+    * remove buffers starting with the ones we created first.  It seems less
+    * likely that these older ones will be needed than the ones that were
+    * just created.
     */
    while (list_length(miinfo->multiInsertBuffers) > MAX_PARTITION_BUFFERS)
    {
index a29c14bf1cf0a9d9495aae3bccde73201f44b1b7..df13b72974ffaba58807c3fe2a4d6f95f76ef02d 100644 (file)
@@ -1790,7 +1790,7 @@ ExecuteTruncateGuts(List *explicit_rels, List *relids, List *relids_logged,
     *
     * We put the ResultRelInfos in the es_opened_result_relations list, even
     * though we don't have a range table and don't populate the
-    * es_result_relations array.  That's a big bogus, but it's enough to make
+    * es_result_relations array.  That's a bit bogus, but it's enough to make
     * ExecGetTriggerResultRel() find them.
     */
    estate = CreateExecutorState();
index 868f8b0858f87d1f47c0a89fa27024f1097cde9c..d76836c09b12ee9a8ba418bbb9232a0dd6e391d9 100644 (file)
@@ -3266,7 +3266,7 @@ ExecBuildAggTransCall(ExprState *state, AggState *aggstate,
     *
     * For ordered aggregates:
     *
-    * Only need to choose between the faster path for a single orderred
+    * Only need to choose between the faster path for a single ordered
     * column, and the one between multiple columns. Checking strictness etc
     * is done when finalizing the aggregate. See
     * process_ordered_aggregate_{single, multi} and
index 6c0d24ee25a5b9c2b6be988d8b0fd2907a6272f6..eb6cc19a60cd96e4384feec230ced3f195fd3912 100644 (file)
@@ -1097,7 +1097,7 @@ ExecEndIncrementalSort(IncrementalSortState *node)
    ExecClearTuple(node->ss.ss_ScanTupleSlot);
    /* must drop pointer to sort result tuple */
    ExecClearTuple(node->ss.ps.ps_ResultTupleSlot);
-   /* must drop stanalone tuple slots from outer node */
+   /* must drop standalone tuple slots from outer node */
    ExecDropSingleTupleTableSlot(node->group_pivot);
    ExecDropSingleTupleTableSlot(node->transfer_tuple);
 
index d85cf7d93e8f49ce5a4b19194d573259e03c78f7..c5896e579089f2685d2480c739d17371db9b769c 100644 (file)
@@ -105,7 +105,7 @@ ExecLimit(PlanState *pstate)
                }
 
                /*
-                * Tuple at limit is needed for comparation in subsequent
+                * Tuple at limit is needed for comparison in subsequent
                 * execution to detect ties.
                 */
                if (node->limitOption == LIMIT_OPTION_WITH_TIES &&
index 803d9bae7f118252046c785a954869d8090b245e..8ad6384c6ae877fa798b5a60a8646ec072773357 100644 (file)
@@ -2915,7 +2915,7 @@ generate_useful_gather_paths(PlannerInfo *root, RelOptInfo *rel, bool override_r
 
            /*
             * If the path has no ordering at all, then we can't use either
-            * incremental sort or rely on implict sorting with a gather
+            * incremental sort or rely on implicit sorting with a gather
             * merge.
             */
            if (subpath->pathkeys == NIL)
index d0ff6602842c9734cd538db49c05c7a0da81e0a2..806629fff210b0df5278e59dfc73a32358d395c9 100644 (file)
@@ -371,7 +371,7 @@ remove_rel_from_query(PlannerInfo *root, int relid, Relids joinrelids)
     * Likewise remove references from PlaceHolderVar data structures,
     * removing any no-longer-needed placeholders entirely.
     *
-    * Removal is a bit tricker than it might seem: we can remove PHVs that
+    * Removal is a bit trickier than it might seem: we can remove PHVs that
     * are used at the target rel and/or in the join qual, but not those that
     * are used at join partner rels or above the join.  It's not that easy to
     * distinguish PHVs used at partner rels from those used in the join qual,
index a4f97c10fe7a79e832dd2bfef78e3fa9e831500e..ac0c495972720b1f0012a6f2b99aa3c4d4ee4d75 100644 (file)
@@ -1783,7 +1783,7 @@ merge_matching_partitions(PartitionMap *outer_map, PartitionMap *inner_map,
    if (outer_merged_index >= 0 && inner_merged_index >= 0)
    {
        /*
-        * If the mereged partitions are the same, no need to do anything;
+        * If the merged partitions are the same, no need to do anything;
         * return the index of the merged partitions.  Otherwise, if each of
         * the given partitions has been merged with a dummy partition on the
         * other side, re-map them to either of the two merged partitions.
index 3d02439b79cea6750933113bf944f26dd1f74974..ee7dbf924ae62c9cb21e641ff1e83b66986ec8dd 100644 (file)
@@ -92,7 +92,7 @@ SignalHandlerForCrashExit(SIGNAL_ARGS)
  * Simple signal handler for triggering a long-running background process to
  * shut down and exit.
  *
- * Typically, this handler would be used for SIGTERM, but some procesess use
+ * Typically, this handler would be used for SIGTERM, but some processes use
  * other signals. In particular, the checkpointer exits on SIGUSR2, the
  * stats collector on SIGQUIT, and the WAL writer exits on either SIGINT
  * or SIGTERM.
index 4e30abb674378c4389effcf34db5b757e9720c00..d950b4eabe00506258b95e025799530eba220cbe 100644 (file)
@@ -1305,7 +1305,7 @@ dependencies_clauselist_selectivity(PlannerInfo *root,
 
    /*
     * Work out which dependencies we can apply, starting with the
-    * widest/stongest ones, and proceeding to smaller/weaker ones.
+    * widest/strongest ones, and proceeding to smaller/weaker ones.
     */
    dependencies = (MVDependency **) palloc(sizeof(MVDependency *) *
                                            total_ndeps);
index 9336f9bc5e90472dea37e984ea1f4ca148ef6168..36326927c6b1293f66b4f5481b9c93d67b8fc58a 100644 (file)
@@ -1403,7 +1403,7 @@ statext_mcv_clauselist_selectivity(PlannerInfo *root, List *clauses, int varReli
        stat_sel = mcv_sel + other_sel;
        CLAMP_PROBABILITY(stat_sel);
 
-       /* Factor the estimate from this MCV to the oveall estimate. */
+       /* Factor the estimate from this MCV to the overall estimate. */
        sel *= stat_sel;
    }
 
index 2fa0b065a2871c54c6a59069407e52fc1c2ba86c..0adf04814cd947c4409a2c75d5b852bf776fdabd 100644 (file)
@@ -560,7 +560,7 @@ PrefetchSharedBuffer(SMgrRelation smgr_reln,
  * could be used by the caller to avoid the need for a later buffer lookup, but
  * it's not pinned, so the caller must recheck it.
  *
- * 2.  If the kernel has been asked to initiate I/O, the initated_io member is
+ * 2.  If the kernel has been asked to initiate I/O, the initiated_io member is
  * true.  Currently there is no way to know if the data was already cached by
  * the kernel and therefore didn't really initiate I/O, and no way to know when
  * the I/O completes other than using synchronous ReadBuffer().
index d7bc330541743d2490eb4b063271f86e45973b92..5512e02940c0e0c7f38bee42886a7b5a7bfcf782 100644 (file)
@@ -6180,7 +6180,7 @@ unicode_normalize_func(PG_FUNCTION_ARGS)
 /*
  * Check whether the string is in the specified Unicode normalization form.
  *
- * This is done by convering the string to the specified normal form and then
+ * This is done by converting the string to the specified normal form and then
  * comparing that to the original string.  To speed that up, we also apply the
  * "quick check" algorithm specified in UAX #15, which can give a yes or no
  * answer for many strings by just scanning the string once.
index 2229c86f9afbc5fe990ba6c9e0fd7cde258d9ffb..a2f1ab5422bcbd344a77ce226b90ef5b7f49e0c2 100644 (file)
@@ -207,7 +207,7 @@ findLastCheckpoint(const char *datadir, XLogRecPtr forkptr, int tliIndex,
        /*
         * Check if it is a checkpoint record. This checkpoint record needs to
         * be the latest checkpoint before WAL forked and not the checkpoint
-        * where the primary has been stopped to be rewinded.
+        * where the primary has been stopped to be rewound.
         */
        info = XLogRecGetInfo(xlogreader) & ~XLR_INFO_MASK;
        if (searchptr < forkptr &&
index cd39f23d5b93761c15259cf3dfad709cd6635ff1..3057665bbec567331ad5ea03d31af707f5e91b4c 100644 (file)
@@ -4185,7 +4185,7 @@ runInitSteps(const char *initialize_steps)
 }
 
 /*
- * Extract pgbench table informations into global variables scale,
+ * Extract pgbench table information into global variables scale,
  * partition_method and partitions.
  */
 static void
index b0ca37c2ed81b3d5fcde105ba9ba8be5c858dbc8..e7781d010f0d73a675d1d4fd6b2ff78a2a077ec5 100644 (file)
@@ -7088,7 +7088,7 @@ pgpassfileWarning(PGconn *conn)
 }
 
 /*
- * Check if the SSL procotol value given in input is valid or not.
+ * Check if the SSL protocol value given in input is valid or not.
  * This is used as a sanity check routine for the connection parameters
  * ssl_min_protocol_version and ssl_max_protocol_version.
  */
index e97a32d5be2aedb34db12dd9926b32275f179a8c..8f4cdab1b3343c50502ad759f66d55e6ad3df35f 100644 (file)
@@ -153,7 +153,7 @@ dibuild(Relation heap, Relation index, IndexInfo *indexInfo)
 }
 
 /*
- * Build an empty index for the initialiation fork.
+ * Build an empty index for the initialization fork.
  */
 static void
 dibuildempty(Relation index)