mirror of
https://github.com/postgres/postgres.git
synced 2025-11-18 02:02:55 +03:00
Lots of doc corrections.
Josh Kupershmidt
This commit is contained in:
@@ -447,9 +447,9 @@ entryIsEnoughSpace(GinBtree btree, Buffer buf, OffsetNumber off)
|
||||
}
|
||||
|
||||
/*
|
||||
* Delete tuple on leaf page if tuples was existed and we
|
||||
* Delete tuple on leaf page if tuples existed and we
|
||||
* should update it, update old child blkno to new right page
|
||||
* if child split is occured
|
||||
* if child split occurred
|
||||
*/
|
||||
static BlockNumber
|
||||
entryPreparePage(GinBtree btree, Page page, OffsetNumber off)
|
||||
|
||||
@@ -856,7 +856,7 @@ ginInsertCleanup(GinState *ginstate,
|
||||
* added to it. If so, process those entries immediately. There
|
||||
* shouldn't be very many, so we don't worry about the fact that
|
||||
* we're doing this with exclusive lock. Insertion algorithm
|
||||
* gurantees that inserted row(s) will not continue on next page.
|
||||
* guarantees that inserted row(s) will not continue on next page.
|
||||
* NOTE: intentionally no vacuum_delay_point in this loop.
|
||||
*/
|
||||
if (PageGetMaxOffsetNumber(page) != maxoff)
|
||||
|
||||
@@ -1580,7 +1580,7 @@ heap_hot_search_buffer(ItemPointer tid, Relation relation, Buffer buffer,
|
||||
break;
|
||||
|
||||
/*
|
||||
* When first_call is true (and thus, skip is initally false) we'll
|
||||
* When first_call is true (and thus, skip is initially false) we'll
|
||||
* return the first tuple we find. But on later passes, heapTuple
|
||||
* will initially be pointing to the tuple we returned last time.
|
||||
* Returning it again would be incorrect (and would loop forever),
|
||||
|
||||
@@ -373,7 +373,7 @@ leaf-item deletions (if the deletion brings the leaf page to zero items,
|
||||
it is now a candidate to be deleted, but that is a separate action).
|
||||
|
||||
An insertion that causes a page split is logged as a single WAL entry for
|
||||
the changes occuring on the insertion's level --- including update of the
|
||||
the changes occurring on the insertion's level --- including update of the
|
||||
right sibling's left-link --- followed by a second WAL entry for the
|
||||
insertion on the parent level (which might itself be a page split, requiring
|
||||
an additional insertion above that, etc).
|
||||
|
||||
@@ -173,7 +173,7 @@ static MultiXactId *OldestVisibleMXactId;
|
||||
* Definitions for the backend-local MultiXactId cache.
|
||||
*
|
||||
* We use this cache to store known MultiXacts, so we don't need to go to
|
||||
* SLRU areas everytime.
|
||||
* SLRU areas every time.
|
||||
*
|
||||
* The cache lasts for the duration of a single transaction, the rationale
|
||||
* for this being that most entries will contain our own TransactionId and
|
||||
|
||||
@@ -7595,7 +7595,7 @@ LogCheckpointEnd(bool restartpoint)
|
||||
* CHECKPOINT_END_OF_RECOVERY: checkpoint is for end of WAL recovery.
|
||||
* CHECKPOINT_IMMEDIATE: finish the checkpoint ASAP,
|
||||
* ignoring checkpoint_completion_target parameter.
|
||||
* CHECKPOINT_FORCE: force a checkpoint even if no XLOG activity has occured
|
||||
* CHECKPOINT_FORCE: force a checkpoint even if no XLOG activity has occurred
|
||||
* since the last one (implied by CHECKPOINT_IS_SHUTDOWN or
|
||||
* CHECKPOINT_END_OF_RECOVERY).
|
||||
*
|
||||
|
||||
@@ -392,7 +392,7 @@ getOidListDiff(Oid *list1, int *nlist1, Oid *list2, int *nlist2)
|
||||
* nnewmembers, newmembers: array of roleids appearing in new ACL
|
||||
*
|
||||
* We calculate the differences between the new and old lists of roles,
|
||||
* and then insert or delete from pg_shdepend as appropiate.
|
||||
* and then insert or delete from pg_shdepend as appropriate.
|
||||
*
|
||||
* Note that we can't just insert all referenced roles blindly during GRANT,
|
||||
* because we would end up with duplicate registered dependencies. We could
|
||||
|
||||
@@ -1984,7 +1984,7 @@ CopyFrom(CopyState cstate)
|
||||
AfterTriggerBeginQuery();
|
||||
|
||||
/*
|
||||
* Check BEFORE STATEMENT insertion triggers. It's debateable whether we
|
||||
* Check BEFORE STATEMENT insertion triggers. It's debatable whether we
|
||||
* should do this for COPY, since it's not really an "INSERT" statement as
|
||||
* such. However, executing these triggers maintains consistency with the
|
||||
* EACH ROW triggers that we already fire on COPY.
|
||||
|
||||
@@ -6247,7 +6247,7 @@ ATExecValidateConstraint(Relation rel, char *constrName, bool recurse,
|
||||
heap_close(refrel, NoLock);
|
||||
|
||||
/*
|
||||
* Foreign keys do not inherit, so we purposedly ignore the
|
||||
* Foreign keys do not inherit, so we purposely ignore the
|
||||
* recursion bit here
|
||||
*/
|
||||
}
|
||||
|
||||
@@ -2754,7 +2754,7 @@ get_rels_with_domain(Oid domainOid, LOCKMODE lockmode)
|
||||
|
||||
/*
|
||||
* Confirm column has not been dropped, and is of the expected type.
|
||||
* This defends against an ALTER DROP COLUMN occuring just before we
|
||||
* This defends against an ALTER DROP COLUMN occurring just before we
|
||||
* acquired lock ... but if the whole table were dropped, we'd still
|
||||
* have a problem.
|
||||
*/
|
||||
|
||||
@@ -1361,7 +1361,7 @@ ExecMergeJoin(MergeJoinState *node)
|
||||
/*
|
||||
* EXEC_MJ_ENDOUTER means we have run out of outer tuples, but
|
||||
* are doing a right/full join and therefore must null-fill
|
||||
* any remaing unmatched inner tuples.
|
||||
* any remaining unmatched inner tuples.
|
||||
*/
|
||||
case EXEC_MJ_ENDOUTER:
|
||||
MJ_printf("ExecMergeJoin: EXEC_MJ_ENDOUTER\n");
|
||||
@@ -1407,7 +1407,7 @@ ExecMergeJoin(MergeJoinState *node)
|
||||
/*
|
||||
* EXEC_MJ_ENDINNER means we have run out of inner tuples, but
|
||||
* are doing a left/full join and therefore must null- fill
|
||||
* any remaing unmatched outer tuples.
|
||||
* any remaining unmatched outer tuples.
|
||||
*/
|
||||
case EXEC_MJ_ENDINNER:
|
||||
MJ_printf("ExecMergeJoin: EXEC_MJ_ENDINNER\n");
|
||||
|
||||
@@ -145,7 +145,7 @@ static int pg_krb5_recvauth(Port *port);
|
||||
#include <com_err.h>
|
||||
#endif
|
||||
/*
|
||||
* Various krb5 state which is not connection specfic, and a flag to
|
||||
* Various krb5 state which is not connection specific, and a flag to
|
||||
* indicate whether we have initialised it yet.
|
||||
*/
|
||||
static int pg_krb5_initialised;
|
||||
|
||||
@@ -9631,7 +9631,7 @@ SimpleTypename:
|
||||
* makes no sense for constructs like CHAR 'hi' and BIT '0101',
|
||||
* where there is an obvious better choice to make.
|
||||
* Note that ConstInterval is not included here since it must
|
||||
* be pushed up higher in the rules to accomodate the postfix
|
||||
* be pushed up higher in the rules to accommodate the postfix
|
||||
* options (e.g. INTERVAL '1' YEAR). Likewise, we have to handle
|
||||
* the generic-type-name case in AExprConst to avoid premature
|
||||
* reduce/reduce conflicts against function names.
|
||||
|
||||
@@ -49,7 +49,7 @@
|
||||
/*
|
||||
* Collation strength (the SQL standard calls this "derivation"). Order is
|
||||
* chosen to allow comparisons to work usefully. Note: the standard doesn't
|
||||
* seem to distingish between NONE and CONFLICT.
|
||||
* seem to distinguish between NONE and CONFLICT.
|
||||
*/
|
||||
typedef enum
|
||||
{
|
||||
|
||||
@@ -486,7 +486,7 @@ pgwin32_select(int nfds, fd_set *readfds, fd_set *writefds, fd_set *exceptfds, c
|
||||
|
||||
/*
|
||||
* Not completed, and not just "would block", so an error
|
||||
* occured
|
||||
* occurred
|
||||
*/
|
||||
FD_SET(writefds->fd_array[i], &outwritefds);
|
||||
}
|
||||
|
||||
@@ -888,7 +888,7 @@ BgWriterShmemInit(void)
|
||||
* CHECKPOINT_END_OF_RECOVERY: checkpoint is for end of WAL recovery.
|
||||
* CHECKPOINT_IMMEDIATE: finish the checkpoint ASAP,
|
||||
* ignoring checkpoint_completion_target parameter.
|
||||
* CHECKPOINT_FORCE: force a checkpoint even if no XLOG activity has occured
|
||||
* CHECKPOINT_FORCE: force a checkpoint even if no XLOG activity has occurred
|
||||
* since the last one (implied by CHECKPOINT_IS_SHUTDOWN or
|
||||
* CHECKPOINT_END_OF_RECOVERY).
|
||||
* CHECKPOINT_WAIT: wait for completion before returning (otherwise,
|
||||
|
||||
@@ -345,7 +345,7 @@ ResetUnloggedRelationsInDbspaceDir(const char *dbspacedirname, int op)
|
||||
/*
|
||||
* Basic parsing of putative relation filenames.
|
||||
*
|
||||
* This funtion returns true if the file appears to be in the correct format
|
||||
* This function returns true if the file appears to be in the correct format
|
||||
* for a non-temporary relation and false otherwise.
|
||||
*
|
||||
* NB: If this function returns true, the caller is entitled to assume that
|
||||
|
||||
@@ -279,10 +279,10 @@ ProcArrayAdd(PGPROC *proc)
|
||||
/*
|
||||
* Keep the procs array sorted by (PGPROC *) so that we can utilize
|
||||
* locality of references much better. This is useful while traversing the
|
||||
* ProcArray because there is a increased likelyhood of finding the next
|
||||
* ProcArray because there is a increased likelihood of finding the next
|
||||
* PGPROC structure in the cache.
|
||||
*
|
||||
* Since the occurance of adding/removing a proc is much lower than the
|
||||
* Since the occurrence of adding/removing a proc is much lower than the
|
||||
* access to the ProcArray itself, the overhead should be marginal
|
||||
*/
|
||||
for (index = 0; index < arrayP->numProcs; index++)
|
||||
|
||||
@@ -1234,7 +1234,7 @@ InitPredicateLocks(void)
|
||||
* that this will prevent resource exhaustion in even the most pessimal
|
||||
* loads up to max_connections = 200 with all 200 connections pounding the
|
||||
* database with serializable transactions. Beyond that, there may be
|
||||
* occassional transactions canceled when trying to flag conflicts. That's
|
||||
* occasional transactions canceled when trying to flag conflicts. That's
|
||||
* probably OK.
|
||||
*/
|
||||
max_table_size *= 5;
|
||||
|
||||
@@ -821,7 +821,7 @@ acldefault(GrantObjectType objtype, Oid ownerId)
|
||||
* owner's ordinary privileges are self-granted; this lets him revoke
|
||||
* them. We implement the owner's grant options without any explicit
|
||||
* "_SYSTEM"-like ACL entry, by internally special-casing the owner
|
||||
* whereever we are testing grant options.
|
||||
* wherever we are testing grant options.
|
||||
*/
|
||||
if (owner_default != ACL_NO_RIGHTS)
|
||||
{
|
||||
|
||||
@@ -2186,7 +2186,7 @@ from_char_parse_int_len(int *dest, char **src, const int len, FormatNode *node)
|
||||
* Don't call this function if the field differs in length from the format
|
||||
* keyword (as with HH24; the keyword length is 4, but the field length is 2).
|
||||
* In such cases, call from_char_parse_int_len() instead to specify the
|
||||
* required length explictly.
|
||||
* required length explicitly.
|
||||
*/
|
||||
static int
|
||||
from_char_parse_int(int *dest, char **src, FormatNode *node)
|
||||
|
||||
@@ -124,7 +124,7 @@ freetree(NODE *node)
|
||||
|
||||
/*
|
||||
* clean tree for ! operator.
|
||||
* It's usefull for debug, but in
|
||||
* It's useful for debug, but in
|
||||
* other case, such view is used with search in index.
|
||||
* Operator ! always return TRUE
|
||||
*/
|
||||
|
||||
@@ -603,7 +603,7 @@ Cover(DocRepresentation *doc, int len, QueryRepresentation *qr, Extention *ext)
|
||||
if (ext->p <= ext->q)
|
||||
{
|
||||
/*
|
||||
* set position for next try to next lexeme after begining of founded
|
||||
* set position for next try to next lexeme after beginning of found
|
||||
* cover
|
||||
*/
|
||||
ext->pos = (ptr - doc) + 1;
|
||||
|
||||
@@ -214,7 +214,7 @@ pg_euccn2wchar_with_len(const unsigned char *from, pg_wchar *to, int len)
|
||||
*to |= *from++;
|
||||
len -= 3;
|
||||
}
|
||||
else if (*from == SS3 && len >= 3) /* code set 3 (unsed ?) */
|
||||
else if (*from == SS3 && len >= 3) /* code set 3 (unused ?) */
|
||||
{
|
||||
from++;
|
||||
*to = (SS3 << 16) | (*from++ << 8);
|
||||
|
||||
Reference in New Issue
Block a user