mirror of
https://github.com/postgres/postgres.git
synced 2025-06-26 12:21:12 +03:00
Fix some grammar and typos in comments and docs
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
This commit is contained in:
@ -560,7 +560,7 @@ verify_heapam_tupdesc(void)
|
|||||||
* Since we do not hold a snapshot, tuple visibility is not a question of
|
* 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
|
* 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
|
* 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
|
* 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.
|
* 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.
|
* the nature of the range violation, if any.
|
||||||
*/
|
*/
|
||||||
static XidBoundsViolation
|
static XidBoundsViolation
|
||||||
|
@ -291,7 +291,7 @@ restart:
|
|||||||
* A stream must be terminated by a normal packet. If the last stream
|
* 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
|
* packet in the source stream is a full packet, a normal empty packet
|
||||||
* must follow. Since the underlying packet reader doesn't know that
|
* 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
|
* terminating packet here. This read does not harm even if the
|
||||||
* stream has already ended.
|
* stream has already ended.
|
||||||
*/
|
*/
|
||||||
|
@ -200,7 +200,7 @@ LOAD 'auto_explain';
|
|||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<varname>auto_explain.log_settings</varname> controls whether information
|
<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
|
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.
|
default value are included in the output. This parameter is off by default.
|
||||||
Only superusers can change this setting.
|
Only superusers can change this setting.
|
||||||
|
@ -3919,7 +3919,7 @@ CREATE INDEX ON measurement (logdate);
|
|||||||
|
|
||||||
<para>
|
<para>
|
||||||
Normally the set of partitions established when initially defining the
|
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
|
remove old partitions of data and periodically add new partitions for
|
||||||
new data. One of the most important advantages of partitioning is
|
new data. One of the most important advantages of partitioning is
|
||||||
precisely that it allows this otherwise painful task to be executed
|
precisely that it allows this otherwise painful task to be executed
|
||||||
|
@ -74,7 +74,7 @@ PostgreSQL documentation
|
|||||||
<application>pg_rewind</application> with the <literal>-c</literal> option to
|
<application>pg_rewind</application> with the <literal>-c</literal> option to
|
||||||
automatically retrieve them from the WAL archive. The use of
|
automatically retrieve them from the WAL archive. The use of
|
||||||
<application>pg_rewind</application> is not limited to failover, e.g., a standby
|
<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.
|
to become a standby again.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
|
@ -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()
|
* This is more complicated than just using GlobalVisTestIsRemovableXid()
|
||||||
* because of old_snapshot_threshold. We only want to increase the threshold
|
* because of old_snapshot_threshold. We only want to increase the threshold
|
||||||
|
@ -3853,7 +3853,7 @@ recomputeNamespacePath(void)
|
|||||||
/*
|
/*
|
||||||
* We want to detect the case where the effective value of the base search
|
* 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
|
* 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 &&
|
if (baseCreationNamespace == firstNS &&
|
||||||
baseTempCreationPending == temp_missing &&
|
baseTempCreationPending == temp_missing &&
|
||||||
|
@ -106,7 +106,7 @@ NamespaceCreate(const char *nspName, Oid ownerId, bool isTemp)
|
|||||||
/* dependency on owner */
|
/* dependency on owner */
|
||||||
recordDependencyOnOwner(NamespaceRelationId, nspoid, ownerId);
|
recordDependencyOnOwner(NamespaceRelationId, nspoid, ownerId);
|
||||||
|
|
||||||
/* dependences on roles mentioned in default ACL */
|
/* dependencies on roles mentioned in default ACL */
|
||||||
recordDependencyOnNewAcl(NamespaceRelationId, nspoid, 0, ownerId, nspacl);
|
recordDependencyOnNewAcl(NamespaceRelationId, nspoid, 0, ownerId, nspacl);
|
||||||
|
|
||||||
/* dependency on extension ... but not for magic temp schemas */
|
/* dependency on extension ... but not for magic temp schemas */
|
||||||
|
@ -2610,9 +2610,9 @@ CopyMultiInsertInfoFlush(CopyMultiInsertInfo *miinfo, ResultRelInfo *curr_rri)
|
|||||||
|
|
||||||
/*
|
/*
|
||||||
* Trim the list of tracked buffers down if it exceeds the limit. Here we
|
* 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
|
* remove buffers starting with the ones we created first. It seems less
|
||||||
* likely that these older ones are less likely to be needed than ones
|
* likely that these older ones will be needed than the ones that were
|
||||||
* that were just created.
|
* just created.
|
||||||
*/
|
*/
|
||||||
while (list_length(miinfo->multiInsertBuffers) > MAX_PARTITION_BUFFERS)
|
while (list_length(miinfo->multiInsertBuffers) > MAX_PARTITION_BUFFERS)
|
||||||
{
|
{
|
||||||
|
@ -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
|
* 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
|
* 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.
|
* ExecGetTriggerResultRel() find them.
|
||||||
*/
|
*/
|
||||||
estate = CreateExecutorState();
|
estate = CreateExecutorState();
|
||||||
|
@ -3266,7 +3266,7 @@ ExecBuildAggTransCall(ExprState *state, AggState *aggstate,
|
|||||||
*
|
*
|
||||||
* For ordered aggregates:
|
* 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
|
* column, and the one between multiple columns. Checking strictness etc
|
||||||
* is done when finalizing the aggregate. See
|
* is done when finalizing the aggregate. See
|
||||||
* process_ordered_aggregate_{single, multi} and
|
* process_ordered_aggregate_{single, multi} and
|
||||||
|
@ -1097,7 +1097,7 @@ ExecEndIncrementalSort(IncrementalSortState *node)
|
|||||||
ExecClearTuple(node->ss.ss_ScanTupleSlot);
|
ExecClearTuple(node->ss.ss_ScanTupleSlot);
|
||||||
/* must drop pointer to sort result tuple */
|
/* must drop pointer to sort result tuple */
|
||||||
ExecClearTuple(node->ss.ps.ps_ResultTupleSlot);
|
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->group_pivot);
|
||||||
ExecDropSingleTupleTableSlot(node->transfer_tuple);
|
ExecDropSingleTupleTableSlot(node->transfer_tuple);
|
||||||
|
|
||||||
|
@ -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.
|
* execution to detect ties.
|
||||||
*/
|
*/
|
||||||
if (node->limitOption == LIMIT_OPTION_WITH_TIES &&
|
if (node->limitOption == LIMIT_OPTION_WITH_TIES &&
|
||||||
|
@ -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
|
* 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.
|
* merge.
|
||||||
*/
|
*/
|
||||||
if (subpath->pathkeys == NIL)
|
if (subpath->pathkeys == NIL)
|
||||||
|
@ -371,7 +371,7 @@ remove_rel_from_query(PlannerInfo *root, int relid, Relids joinrelids)
|
|||||||
* Likewise remove references from PlaceHolderVar data structures,
|
* Likewise remove references from PlaceHolderVar data structures,
|
||||||
* removing any no-longer-needed placeholders entirely.
|
* 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 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
|
* 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,
|
* distinguish PHVs used at partner rels from those used in the join qual,
|
||||||
|
@ -1783,7 +1783,7 @@ merge_matching_partitions(PartitionMap *outer_map, PartitionMap *inner_map,
|
|||||||
if (outer_merged_index >= 0 && inner_merged_index >= 0)
|
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
|
* return the index of the merged partitions. Otherwise, if each of
|
||||||
* the given partitions has been merged with a dummy partition on the
|
* the given partitions has been merged with a dummy partition on the
|
||||||
* other side, re-map them to either of the two merged partitions.
|
* other side, re-map them to either of the two merged partitions.
|
||||||
|
@ -92,7 +92,7 @@ SignalHandlerForCrashExit(SIGNAL_ARGS)
|
|||||||
* Simple signal handler for triggering a long-running background process to
|
* Simple signal handler for triggering a long-running background process to
|
||||||
* shut down and exit.
|
* 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
|
* other signals. In particular, the checkpointer exits on SIGUSR2, the
|
||||||
* stats collector on SIGQUIT, and the WAL writer exits on either SIGINT
|
* stats collector on SIGQUIT, and the WAL writer exits on either SIGINT
|
||||||
* or SIGTERM.
|
* or SIGTERM.
|
||||||
|
@ -1305,7 +1305,7 @@ dependencies_clauselist_selectivity(PlannerInfo *root,
|
|||||||
|
|
||||||
/*
|
/*
|
||||||
* Work out which dependencies we can apply, starting with the
|
* 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 *) *
|
dependencies = (MVDependency **) palloc(sizeof(MVDependency *) *
|
||||||
total_ndeps);
|
total_ndeps);
|
||||||
|
@ -1403,7 +1403,7 @@ statext_mcv_clauselist_selectivity(PlannerInfo *root, List *clauses, int varReli
|
|||||||
stat_sel = mcv_sel + other_sel;
|
stat_sel = mcv_sel + other_sel;
|
||||||
CLAMP_PROBABILITY(stat_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;
|
sel *= stat_sel;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -560,7 +560,7 @@ PrefetchSharedBuffer(SMgrRelation smgr_reln,
|
|||||||
* could be used by the caller to avoid the need for a later buffer lookup, but
|
* 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.
|
* 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
|
* 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 kernel and therefore didn't really initiate I/O, and no way to know when
|
||||||
* the I/O completes other than using synchronous ReadBuffer().
|
* the I/O completes other than using synchronous ReadBuffer().
|
||||||
|
@ -6180,7 +6180,7 @@ unicode_normalize_func(PG_FUNCTION_ARGS)
|
|||||||
/*
|
/*
|
||||||
* Check whether the string is in the specified Unicode normalization form.
|
* 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
|
* 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
|
* "quick check" algorithm specified in UAX #15, which can give a yes or no
|
||||||
* answer for many strings by just scanning the string once.
|
* answer for many strings by just scanning the string once.
|
||||||
|
@ -207,7 +207,7 @@ findLastCheckpoint(const char *datadir, XLogRecPtr forkptr, int tliIndex,
|
|||||||
/*
|
/*
|
||||||
* Check if it is a checkpoint record. This checkpoint record needs to
|
* Check if it is a checkpoint record. This checkpoint record needs to
|
||||||
* be the latest checkpoint before WAL forked and not the checkpoint
|
* 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;
|
info = XLogRecGetInfo(xlogreader) & ~XLR_INFO_MASK;
|
||||||
if (searchptr < forkptr &&
|
if (searchptr < forkptr &&
|
||||||
|
@ -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.
|
* partition_method and partitions.
|
||||||
*/
|
*/
|
||||||
static void
|
static void
|
||||||
|
@ -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
|
* This is used as a sanity check routine for the connection parameters
|
||||||
* ssl_min_protocol_version and ssl_max_protocol_version.
|
* ssl_min_protocol_version and ssl_max_protocol_version.
|
||||||
*/
|
*/
|
||||||
|
@ -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
|
static void
|
||||||
dibuildempty(Relation index)
|
dibuildempty(Relation index)
|
||||||
|
Reference in New Issue
Block a user