diff --git a/doc/src/sgml/bgworker.sgml b/doc/src/sgml/bgworker.sgml index d3c8ddb382f..d53570d9862 100644 --- a/doc/src/sgml/bgworker.sgml +++ b/doc/src/sgml/bgworker.sgml @@ -69,7 +69,7 @@ typedef struct BackgroundWorker - bgw_flags is a bitwise-or'd bitmask indicating the + bgw_flags is a bitwise-or'd bit mask indicating the capabilities that the module wants. Possible values are BGWORKER_SHMEM_ACCESS (requesting shared memory access) and BGWORKER_BACKEND_DATABASE_CONNECTION (requesting the @@ -114,14 +114,14 @@ typedef struct BackgroundWorker passed at registration time. bgw_main may be NULL; in that case, bgw_library_name and bgw_function_name will be used to determine - the entrypoint. This is useful for background workers launched after + the entry point. This is useful for background workers launched after postmaster startup, where the postmaster does not have the requisite library loaded. bgw_library_name is the name of a library in - which the initial entrypoint for the background worker should be sought. + which the initial entry point for the background worker should be sought. It is ignored unless bgw_main is NULL. But if bgw_main is NULL, then the named library will be dynamically loaded by the worker process and @@ -131,7 +131,7 @@ typedef struct BackgroundWorker bgw_function_name is the name of a function in - a dynamically loaded library which should be used as the initial entrypoint + a dynamically loaded library which should be used as the initial entry point for a new background worker. It is ignored unless bgw_main is NULL. diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml index b4a06e48348..68f84343520 100644 --- a/doc/src/sgml/catalogs.sgml +++ b/doc/src/sgml/catalogs.sgml @@ -408,13 +408,13 @@ aggfinalextra bool - True to pass extra dummy arguments to aggfinalfn + True to pass extra dummy arguments to aggfinalfn aggmfinalextra bool - True to pass extra dummy arguments to aggmfinalfn + True to pass extra dummy arguments to aggmfinalfn aggsortop @@ -838,7 +838,7 @@ amopsortfamily oid pg_opfamily.oid - The btree operator family this entry sorts according to, if an + The B-tree operator family this entry sorts according to, if an ordering operator; zero if a search operator @@ -853,7 +853,7 @@ indexed_column operator constant. - Obviously, such an operator must return boolean, and its left-hand input + Obviously, such an operator must return boolean, and its left-hand input type must match the index's column data type. @@ -868,13 +868,13 @@ its left-hand input type must match the index's column data type. The exact semantics of the ORDER BY are specified by the amopsortfamily column, which must reference - a btree operator family for the operator's result type. + a B-tree operator family for the operator's result type. At present, it's assumed that the sort order for an ordering operator - is the default for the referenced opfamily, i.e., ASC NULLS + is the default for the referenced operator family, i.e., ASC NULLS LAST. This might someday be relaxed by adding additional columns to specify sort options explicitly. @@ -974,7 +974,7 @@ these match the input data type(s) of the support procedure itself, for others not. There is a notion of default support procedures for an index, which are those with amproclefttype and - amprocrighttype both equal to the index opclass's + amprocrighttype both equal to the index operator class's opcintype. @@ -1959,7 +1959,7 @@ d = default (primary key, if any), n = nothing, f = all columns - i = index with indisreplident set, or default + i = index with indisreplident set, or default @@ -5261,7 +5261,7 @@ plugin name - The basename of the shared object containing the output plugin this logical slot is using, or null for physical slots. + The base name of the shared object containing the output plugin this logical slot is using, or null for physical slots. @@ -5275,7 +5275,7 @@ datoid oid pg_database.oid - The oid of the database this slot is associated with, or + The OID of the database this slot is associated with, or null. Only logical slots have an associated database. diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index d8cde22d5d9..0608a0cdf71 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -2603,7 +2603,7 @@ include_dir 'conf.d' The name of a standby server for this purpose is the application_name setting of the standby, as set in the - primary_conninfo of the standby's walreceiver. There is + primary_conninfo of the standby's WAL receiver. There is no mechanism to enforce uniqueness. In case of duplicates one of the matching standbys will be chosen to be the synchronous standby, though exactly which one is indeterminate. diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml index 790ba9e3dd6..5be6de79412 100644 --- a/doc/src/sgml/datatype.sgml +++ b/doc/src/sgml/datatype.sgml @@ -4487,7 +4487,7 @@ SELECT * FROM pg_attribute The pg_lsn data type can be used to store LSN (Log Sequence Number) data which is a pointer to a location in the XLOG. This type is a - representation of XLogRecPtr and an internal system type of + representation of XLogRecPtr and an internal system type of PostgreSQL. diff --git a/doc/src/sgml/fdwhandler.sgml b/doc/src/sgml/fdwhandler.sgml index 6b5c8b7e97b..9069cebb900 100644 --- a/doc/src/sgml/fdwhandler.sgml +++ b/doc/src/sgml/fdwhandler.sgml @@ -353,7 +353,7 @@ PlanForeignModify (PlannerInfo *root, plan is the ModifyTable plan node, which is complete except for the fdwPrivLists field. resultRelation identifies the target foreign table by its - rangetable index. subplan_index identifies which target of + range table index. subplan_index identifies which target of the ModifyTable plan node this is, counting from zero; use this if you want to index into plan->plans or other substructure of the plan node. @@ -430,7 +430,7 @@ ExecForeignInsert (EState *estate, rinfo is the ResultRelInfo struct describing the target foreign table. slot contains the tuple to be inserted; it will match the - rowtype definition of the foreign table. + row-type definition of the foreign table. planSlot contains the tuple that was generated by the ModifyTable plan node's subplan; it differs from slot in possibly containing additional junk @@ -476,7 +476,7 @@ ExecForeignUpdate (EState *estate, rinfo is the ResultRelInfo struct describing the target foreign table. slot contains the new data for the tuple; it will match the - rowtype definition of the foreign table. + row-type definition of the foreign table. planSlot contains the tuple that was generated by the ModifyTable plan node's subplan; it differs from slot in possibly containing additional junk @@ -576,7 +576,7 @@ IsForeignRelUpdatable (Relation rel); Report which update operations the specified foreign table supports. - The return value should be a bitmask of rule event numbers indicating + The return value should be a bit mask of rule event numbers indicating which operations are supported by the foreign table, using the CmdType enumeration; that is, (1 << CMD_UPDATE) = 4 for UPDATE, diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index 6c4a15515b4..bf131403b0b 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -10086,7 +10086,7 @@ table2-mapping shows the operators that - are available for use with the two JSON datatypes (see ). @@ -10162,7 +10162,7 @@ table2-mapping The standard comparison operators shown in are available for jsonb, but not for json. They follow the - ordering rules for btree operations outlined at . @@ -10269,7 +10269,7 @@ table2-mapping (recursively) to arrays and objects; otherwise, if there is a cast from the type to json, the cast function will be used to perform the conversion; otherwise, a JSON scalar value is produced. - For any scalar type other than a number, a boolean, or a null value, + For any scalar type other than a number, a Boolean, or a null value, the text representation will be used, properly quoted and escaped so that it is a valid JSON string. @@ -14007,7 +14007,7 @@ AND These operators compare the internal binary representation of the two rows. Two rows might have a different binary representation even though comparisons of the two rows with the equality operator is true. - The ordering of rows under these comparision operators is deterministic + The ordering of rows under these comparison operators is deterministic but not otherwise meaningful. These operators are used internally for materialized views and might be useful for other specialized purposes such as replication but are not intended to be generally useful for @@ -15461,32 +15461,32 @@ SELECT pg_type_is_visible('myschema.widget'::regtype); to_regclass(rel_name) regclass - get the oid of the named relation + get the OID of the named relation to_regproc(func_name) regproc - get the oid of the named function + get the OID of the named function to_regprocedure(func_name) regprocedure - get the oid of the named function + get the OID of the named function to_regoper(operator_name) regoper - get the oid of the named operator + get the OID of the named operator to_regoperator(operator_name) regoperator - get the oid of the named operator + get the OID of the named operator to_regtype(type_name) regtype - get the oid of the named type + get the OID of the named type @@ -16619,8 +16619,8 @@ postgres=# SELECT * FROM pg_xlogfile_name_offset(pg_stop_backup()); Creates a new physical replication slot named slot_name. Streaming changes from a physical slot - is only possible with the walsender protocol - see . Corresponds to the walsender protocol + is only possible with the streaming-replication protocol - see . Corresponds to the replication protocol command CREATE_REPLICATION_SLOT ... PHYSICAL. @@ -16636,7 +16636,7 @@ postgres=# SELECT * FROM pg_xlogfile_name_offset(pg_stop_backup()); Drops the physical or logical replication slot - named slot_name. Same as walsender protocol + named slot_name. Same as replication protocol command DROP_REPLICATION_SLOT. diff --git a/doc/src/sgml/high-availability.sgml b/doc/src/sgml/high-availability.sgml index 657097d6460..d249959f205 100644 --- a/doc/src/sgml/high-availability.sgml +++ b/doc/src/sgml/high-availability.sgml @@ -1894,7 +1894,7 @@ if (!triggered) might want to make adjustments to handle the period when hot_standby_feedback feedback is not being provided. For example, consider increasing max_standby_archive_delay - so that queries are not rapidly cancelled by conflicts in WAL archive + so that queries are not rapidly canceled by conflicts in WAL archive files during disconnected periods. You should also consider increasing max_standby_streaming_delay to avoid rapid cancellations by newly-arrived streaming WAL entries after reconnection. diff --git a/doc/src/sgml/indexam.sgml b/doc/src/sgml/indexam.sgml index fd1168991ad..157047a23ab 100644 --- a/doc/src/sgml/indexam.sgml +++ b/doc/src/sgml/indexam.sgml @@ -168,7 +168,7 @@ ambuild (Relation heapRelation, void ambuildempty (Relation indexRelation); - Build an empty index, and write it to the initialization fork (INIT_FORKNUM) + Build an empty index, and write it to the initialization fork (INIT_FORKNUM) of the given relation. This method is called only for unlogged tables; the empty index written to the initialization fork will be copied over the main relation fork on each server restart. @@ -278,7 +278,7 @@ amcanreturn (Relation indexRelation); Check whether the index can support index-only scans by returning the indexed column values for an index entry in the form of an - IndexTuple. Return TRUE if so, else FALSE. If the index AM can never + IndexTuple. Return TRUE if so, else FALSE. If the index AM can never support index-only scans (an example is hash, which stores only the hash values not the original data), it is sufficient to set its amcanreturn field to zero in pg_am. diff --git a/doc/src/sgml/json.sgml b/doc/src/sgml/json.sgml index 4fadf65558e..a56942a9496 100644 --- a/doc/src/sgml/json.sgml +++ b/doc/src/sgml/json.sgml @@ -354,7 +354,7 @@ SELECT '"foo"'::jsonb ? 'foo'; keys or key/value pairs occurring within a large number of jsonb documents (datums). Two GIN operator classes are provided, offering different - performance and flexibility tradeoffs. + performance and flexibility trade-offs. The default GIN operator class for jsonb supports queries with diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml index 0d98bb0420c..1961ce58753 100644 --- a/doc/src/sgml/libpq.sgml +++ b/doc/src/sgml/libpq.sgml @@ -136,7 +136,7 @@ PGconn *PQconnectdbParams(const char * const *keywords, - If any parameter is NULL or an emptry string, the corresponding + If any parameter is NULL or an emptry string, the corresponding environment variable (see ) is checked. If the environment variable is not set either, then the indicated built-in defaults are used. diff --git a/doc/src/sgml/logicaldecoding.sgml b/doc/src/sgml/logicaldecoding.sgml index 41b63b4a039..35928824110 100644 --- a/doc/src/sgml/logicaldecoding.sgml +++ b/doc/src/sgml/logicaldecoding.sgml @@ -310,7 +310,7 @@ CTRL-C An output plugin is loaded by dynamically loading a shared library with - the output plugin's name as the library basename. The normal library + the output plugin's name as the library base name. The normal library search path is used to locate the library. To provide the required output plugin callbacks and to indicate that the library is actually an output plugin it needs to provide a function named @@ -362,8 +362,8 @@ CREATE TABLE another_catalog_table(data text) WITH (user_catalog_table = true); various callbacks it needs to provide. - Concurrent transactions are decoded in commit order and only changes - belonging to a specific transaction are decoded inbetween + Concurrent transactions are decoded in commit order, and only changes + belonging to a specific transaction are decoded between the begin and commit callbacks. Transactions that were rolled back explicitly or implicitly never get @@ -432,7 +432,7 @@ typedef void (*LogicalDecodeShutdownCB) ( Transaction Begin Callback The required begin_cb callback is called whenever a - start of a commited transaction has been decoded. Aborted transactions + start of a committed transaction has been decoded. Aborted transactions and their contents never get decoded. typedef void (*LogicalDecodeBeginCB) ( @@ -441,7 +441,7 @@ typedef void (*LogicalDecodeBeginCB) ( ); The txn parameter contains meta information about - the transaction, like the timestamp at which it has been committed and + the transaction, like the time stamp at which it has been committed and its XID. @@ -469,7 +469,7 @@ typedef void (*LogicalDecodeCommitCB) ( individual row modification inside a transaction, may it be an INSERT, UPDATE or DELETE. Even if the original command modified - several rows at once the callback will be called indvidually for each + several rows at once the callback will be called individually for each row. typedef void (*LogicalDecodeChangeCB) ( diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml index 69d99e7c75f..db0da41b9b1 100644 --- a/doc/src/sgml/monitoring.sgml +++ b/doc/src/sgml/monitoring.sgml @@ -631,7 +631,7 @@ postgres: user database host backend_xid xid - Toplevel transaction identifier of this backend, if any. + Top-level transaction identifier of this backend, if any. backend_xmin diff --git a/doc/src/sgml/perform.sgml b/doc/src/sgml/perform.sgml index 657575c07ad..94c11adaa49 100644 --- a/doc/src/sgml/perform.sgml +++ b/doc/src/sgml/perform.sgml @@ -442,7 +442,7 @@ WHERE t1.unique1 < 10 AND t2.unique2 < 10 AND t1.hundred < t2.hundred; Notice that here the planner has chosen to materialize the inner relation of the join, by putting a Materialize plan node atop it. This - means that the t2 indexscan will be done just once, even + means that the t2 index scan will be done just once, even though the nested-loop join node needs to read that data ten times, once for each row from the outer relation. The Materialize node saves the data in memory as it's read, and then returns the data from memory on each diff --git a/doc/src/sgml/pgstatstatements.sgml b/doc/src/sgml/pgstatstatements.sgml index db6b10abc40..a58ecf7065f 100644 --- a/doc/src/sgml/pgstatstatements.sgml +++ b/doc/src/sgml/pgstatstatements.sgml @@ -199,7 +199,7 @@ For security reasons, non-superusers are not allowed to see the SQL - text or queryid of queries executed by other users. They can see + text or queryid of queries executed by other users. They can see the statistics, however, if the view has been installed in their database. diff --git a/doc/src/sgml/plpgsql.sgml b/doc/src/sgml/plpgsql.sgml index 4cb5868cda3..e3b03f7004a 100644 --- a/doc/src/sgml/plpgsql.sgml +++ b/doc/src/sgml/plpgsql.sgml @@ -2714,7 +2714,7 @@ GET STACKED DIAGNOSTICS variable { = | := } PG_DATATYPE_NAME text - the name of datatype related to exception + the name of data type related to exception MESSAGE_TEXT diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml index 11b4d9a0dde..cda546a3b0e 100644 --- a/doc/src/sgml/protocol.sgml +++ b/doc/src/sgml/protocol.sgml @@ -1302,7 +1302,7 @@ To initiate streaming replication, the frontend sends the -replication parameter in the startup message. A boolean value +replication parameter in the startup message. A Boolean value of true tells the backend to go into walsender mode, wherein a small set of replication commands can be issued instead of SQL statements. Only the simple query protocol can be used in walsender mode. diff --git a/doc/src/sgml/queries.sgml b/doc/src/sgml/queries.sgml index 18faace5a14..c5e8aefabd5 100644 --- a/doc/src/sgml/queries.sgml +++ b/doc/src/sgml/queries.sgml @@ -650,7 +650,7 @@ FROM (VALUES ('anne', 'smith'), ('bob', 'jones'), ('joe', 'blow')) Table functions may also be combined using the ROWS FROM syntax, with the results returned in parallel columns; the number of result rows in this case is that of the largest function result, with - smaller results padded with NULLs to match. + smaller results padded with null values to match. diff --git a/doc/src/sgml/recovery-config.sgml b/doc/src/sgml/recovery-config.sgml index ba68ddd4eb4..0f1ff343a6c 100644 --- a/doc/src/sgml/recovery-config.sgml +++ b/doc/src/sgml/recovery-config.sgml @@ -427,7 +427,7 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows on master and the time on the current standby. Delays in transfer because of networks or cascading replication configurations may reduce the actual wait time significantly. If the system - clocks on master and standby are not synchronised, this may lead to + clocks on master and standby are not synchronized, this may lead to recovery applying records earlier than expected; but that is not a major issue because useful settings of the parameter are much larger than typical time deviations between servers. Be careful to allow for @@ -445,7 +445,7 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows This parameter is intended for use with streaming replication deployments, - however, if the parameter is specified it will be honoured in all cases. + however, if the parameter is specified it will be honored in all cases. Synchronous replication is not affected by this setting because there is not yet any setting to request synchronous apply of transaction commits. hot_standby_feedback will be delayed by use of this feature diff --git a/doc/src/sgml/ref/create_aggregate.sgml b/doc/src/sgml/ref/create_aggregate.sgml index 84a18b27960..d61a22e7554 100644 --- a/doc/src/sgml/ref/create_aggregate.sgml +++ b/doc/src/sgml/ref/create_aggregate.sgml @@ -207,7 +207,7 @@ CREATE AGGREGATE name ( arguments that are evaluated only once per aggregation rather than once per input row. Hypothetical-set aggregates are a subclass of ordered-set aggregates in which some of the direct arguments are required to match, - in number and datatypes, the aggregated argument columns. This allows + in number and data types, the aggregated argument columns. This allows the values of those direct arguments to be added to the collection of aggregate-input rows as an additional hypothetical row. diff --git a/doc/src/sgml/ref/create_view.sgml b/doc/src/sgml/ref/create_view.sgml index a13f1cbde35..2b7a98fe692 100644 --- a/doc/src/sgml/ref/create_view.sgml +++ b/doc/src/sgml/ref/create_view.sgml @@ -358,7 +358,7 @@ CREATE VIEW vista AS SELECT text 'Hello World' AS hello; If an automatically updatable view is marked with the security_barrier property then all the view's WHERE - conditions (and any conditions using operators which are marked as LEAKPROOF) + conditions (and any conditions using operators which are marked as LEAKPROOF) will always be evaluated before any conditions that a user of the view has added. See for full details. Note that, due to this, rows which are not ultimately returned (because they do not diff --git a/doc/src/sgml/ref/pg_recvlogical.sgml b/doc/src/sgml/ref/pg_recvlogical.sgml index edc52c0d694..ce5ad5eed9e 100644 --- a/doc/src/sgml/ref/pg_recvlogical.sgml +++ b/doc/src/sgml/ref/pg_recvlogical.sgml @@ -183,7 +183,7 @@ PostgreSQL documentation The following command-line options control the location and format of the - output and other replication behaviour: + output and other replication behavior: diff --git a/doc/src/sgml/release-9.4.sgml b/doc/src/sgml/release-9.4.sgml index 0151febf9fb..88935444997 100644 --- a/doc/src/sgml/release-9.4.sgml +++ b/doc/src/sgml/release-9.4.sgml @@ -111,13 +111,13 @@ - Tighten checks for multi-dimensional array input (Bruce Momjian) Previously an input array string that started with a single-element - array dimension could later contain multi-dimensional segments, + array dimension could later contain multidimensional segments, e.g. '{{1}, {2,3}}'::int[]. @@ -198,7 +198,7 @@ Rename EXPLAIN - ANALYZE's "total runtime" output to "execution time" + ANALYZE's total runtime output to execution time (Tom Lane) @@ -565,7 +565,7 @@ - Improve speed of accesessing many different sequences in the same session (David Rowley) @@ -775,7 +775,7 @@ - Allow printf-style space padding to be specified in printf-style space padding to be specified in log_line_prefix (David Rowley) @@ -1098,7 +1098,7 @@ Previously only unquoted matching strings would be imported - as NULLs. + as null values. @@ -1370,23 +1370,23 @@ Add structured (non-text) data type (JSONB) for storing - JSON data (Oleg Bartunov, Teodor Sigaev, Alexander + linkend="datatype-json">jsonb) for storing + JSON data (Oleg Bartunov, Teodor Sigaev, Alexander Korotkov, Peter Geoghegan, and Andrew Dunstan) - This allows for faster access to values in the JSON - document and faster and more useful indexing of JSON. - Scalar values in JSONB documents are typed as appropriate + This allows for faster access to values in the JSON + document and faster and more useful indexing of JSON. + Scalar values in jsonb documents are typed as appropriate scalar SQL types. - Add new JSON functions to allow for the construction - of arbitrarily complex json trees (Andrew Dunstan, Laurence Rowe) + Add new JSON functions to allow for the construction + of arbitrarily complex JSON trees (Andrew Dunstan, Laurence Rowe) @@ -1402,7 +1402,7 @@ Add json_typeof() - to return the data type of a JSON value (Andrew Tipton) + to return the data type of a json value (Andrew Tipton) @@ -1782,14 +1782,14 @@ - Allow sizeof() in ecpg + Allow sizeof() in ECPG C array definitions (Michael Meskes) - Have ecpg properly handle nesting + Have ECPG properly handle nesting requirements in C and SQL mode for C-style comments (Michael Meskes) @@ -1871,12 +1871,12 @@ Have psql \d+ output an - OID line only if an oid column exists in a table + OID line only if an oid column exists in a table (Bruce Momjian) - Previously, the presence or absence of an oid column was always + Previously, the presence or absence of an oid column was always reported. @@ -2251,7 +2251,7 @@ - Avoid most uses of dlltool in Cygwin and + Avoid most uses of dlltool in Cygwin and Mingw builds (Marco Atzeri, Hiroshi Inoue) @@ -2294,7 +2294,7 @@ This allows the creation of version 4 UUIDs without - requiring the installation of uuid-ossp. + requiring the installation of uuid-ossp. @@ -2317,11 +2317,11 @@ Have pgstattuple - functions use regclass-type arguments (Satoshi Nagayasu) + functions use regclass-type arguments (Satoshi Nagayasu) - While text-type arguments are still supported, they will be + While text-type arguments are still supported, they will be removed in a later major release. diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml index 9fadef5c9da..b6ba1c7e137 100644 --- a/doc/src/sgml/runtime.sgml +++ b/doc/src/sgml/runtime.sgml @@ -1330,7 +1330,7 @@ echo -1000 > /proc/self/oom_score_adj setting vm.nr_hugepages. To estimate the number of necessary huge pages start PostgreSQL without huge pages enabled and check the VmPeak value from the - proc filesystem: + proc file system: $ head -1 /path/to/data/directory/postmaster.pid 4170 diff --git a/doc/src/sgml/spi.sgml b/doc/src/sgml/spi.sgml index d8af07e5d2f..c099fcfad3a 100644 --- a/doc/src/sgml/spi.sgml +++ b/doc/src/sgml/spi.sgml @@ -1179,7 +1179,7 @@ SPIPlanPtr SPI_prepare_params(const char * command, void * parserSetupArg - passthrough argument for parserSetup + pass-through argument for parserSetup diff --git a/doc/src/sgml/xaggr.sgml b/doc/src/sgml/xaggr.sgml index bf3fba84922..cc8ec64f235 100644 --- a/doc/src/sgml/xaggr.sgml +++ b/doc/src/sgml/xaggr.sgml @@ -217,8 +217,8 @@ CREATE AGGREGATE sum (complex) The forward transition function for moving-aggregate mode is not allowed - to return NULL as the new state value. If the inverse transition - function returns NULL, this is taken as an indication that the inverse + to return null as the new state value. If the inverse transition + function returns null, this is taken as an indication that the inverse function cannot reverse the state calculation for this particular input, and so the aggregate calculation will be redone from scratch for the current frame starting position. This convention allows moving-aggregate @@ -352,7 +352,7 @@ SELECT attrelid::regclass, array_accum(atttypid::regtype) no SQL-level equivalent for it. To address this case, it is possible to declare the final function as taking extra dummy arguments that match the input arguments of the aggregate. Such dummy arguments - are always passed as NULLs since no specific value is available when the + are always passed as null values since no specific value is available when the final function is called. Their only use is to allow a polymorphic final function's result type to be connected to the aggregate's input type(s). For example, the definition of the built-in @@ -484,7 +484,7 @@ SELECT percentile_disc(0.5) WITHIN GROUP (ORDER BY income) FROM households; While normal aggregates can often be implemented with support functions written in PL/pgSQL or another PL language, ordered-set aggregates generally have to be written in - C, since their state values aren't definable as any SQL datatype. + C, since their state values aren't definable as any SQL data type. (In the above example, notice that the state value is declared as type internal — this is typical.) @@ -496,7 +496,7 @@ SELECT percentile_disc(0.5) WITHIN GROUP (ORDER BY income) FROM households; same definition as for normal aggregates, but note that the direct arguments (if any) are not provided. The final function receives the last state value, the values of the direct arguments if any, - and (if finalfunc_extra is specified) NULL values + and (if finalfunc_extra is specified) null values corresponding to the aggregated input(s). As with normal aggregates, finalfunc_extra is only really useful if the aggregate is polymorphic; then the extra dummy argument(s) are needed diff --git a/doc/src/sgml/xindex.sgml b/doc/src/sgml/xindex.sgml index 0fe97ba4b5d..4fac018772c 100644 --- a/doc/src/sgml/xindex.sgml +++ b/doc/src/sgml/xindex.sgml @@ -568,7 +568,7 @@ consistent - determine whether value matches query condition (boolean variant) + determine whether value matches query condition (Boolean variant) (optional if support function 6 is present) 4 diff --git a/doc/src/sgml/xml2.sgml b/doc/src/sgml/xml2.sgml index df0f53c5499..47ea7166fd1 100644 --- a/doc/src/sgml/xml2.sgml +++ b/doc/src/sgml/xml2.sgml @@ -154,7 +154,7 @@ - Like xpath_nodeset(document, query, toptag, itemtag) but result omits toptag. + Like xpath_nodeset(document, query, toptag, itemtag) but result omits toptag. @@ -460,7 +460,7 @@ xslt_process(text document, text stylesheet, text paramlist) returns text Development of this module was sponsored by Torchbox Ltd. (www.torchbox.com). - It has the same BSD licence as PostgreSQL. + It has the same BSD license as PostgreSQL.