diff --git a/doc/src/sgml/archive-modules.sgml b/doc/src/sgml/archive-modules.sgml index 7cf44e82e23..7064307d9e6 100644 --- a/doc/src/sgml/archive-modules.sgml +++ b/doc/src/sgml/archive-modules.sgml @@ -50,7 +50,7 @@ _PG_archive_module_init. The result of the function must be a pointer to a struct of type ArchiveModuleCallbacks, which contains everything - that the core code needs to know how to make use of the archive module. The + that the core code needs to know to make use of the archive module. The return value needs to be of server lifetime, which is typically achieved by defining it as a static const variable in global scope. @@ -82,7 +82,7 @@ typedef const ArchiveModuleCallbacks *(*ArchiveModuleInit) (void); The startup_cb callback is called shortly after the module is loaded. This callback can be used to perform any additional - initialization required. If the archive module has a state, it can use + initialization required. If the archive module has any state, it can use state->private_data to store it. @@ -143,7 +143,7 @@ typedef bool (*ArchiveFileCB) (ArchiveModuleState *state, const char *file, cons process exits (e.g., after an error) or the value of changes. If no shutdown_cb is defined, no special action is taken in - these situations. If the archive module has a state, this callback should + these situations. If the archive module has any state, this callback should free it to avoid leaks. diff --git a/doc/src/sgml/client-auth.sgml b/doc/src/sgml/client-auth.sgml index b9d73deced2..bcdc085010a 100644 --- a/doc/src/sgml/client-auth.sgml +++ b/doc/src/sgml/client-auth.sgml @@ -810,7 +810,7 @@ host all all ::1/128 trust host all all localhost trust # The same using a regular expression for DATABASE, that allows connection -# to the database db1, db2 and any databases with a name beginning by "db" +# to the database db1, db2 and any databases with a name beginning with "db" # and finishing with a number using two to four digits (like "db1234" or # "db12"). # diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index f81c2045ec4..20b8b5ae1de 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -11835,7 +11835,7 @@ LOG: CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1) option of CREATE SUBSCRIPTION is enabled, otherwise, serialize each change. When set to - buffered, the decoding will stream or serialize + buffered, decoding will stream or serialize changes when logical_decoding_work_mem is reached. diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index e6a7514100e..9c3b2018896 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -27084,8 +27084,9 @@ postgres=# SELECT '0/0'::pg_lsn + pd.segment_number * ps.setting::int + :offset Take a snapshot of running transactions and write it to WAL, without - having to wait bgwriter or checkpointer to log one. This is useful for - logical decoding on standby, as logical slot creation has to wait + having to wait for bgwriter or + checkpointer to log one. This is useful for + logical decoding on a standby, as logical slot creation has to wait until such a record is replayed on the standby. diff --git a/doc/src/sgml/indexam.sgml b/doc/src/sgml/indexam.sgml index 29ece7c42ee..e813e2b620a 100644 --- a/doc/src/sgml/indexam.sgml +++ b/doc/src/sgml/indexam.sgml @@ -257,7 +257,7 @@ typedef struct IndexAmRoutine Access methods that do not point to individual tuples, but to block ranges (like BRIN), may allow the HOT optimization to continue. This does not apply to attributes referenced in index - predicates, an update of such attribute always disables HOT. + predicates, an update of such an attribute always disables HOT. diff --git a/doc/src/sgml/install-windows.sgml b/doc/src/sgml/install-windows.sgml index 2db44db2fd9..cbc70a039c2 100644 --- a/doc/src/sgml/install-windows.sgml +++ b/doc/src/sgml/install-windows.sgml @@ -550,7 +550,7 @@ $ENV{PROVE_TESTS}='t/020*.pl t/010*.pl' OPENSSL - Path to a openssl command. The default is + Path to an openssl command. The default is openssl, which will search for a command by that name in the configured PATH. diff --git a/doc/src/sgml/logicaldecoding.sgml b/doc/src/sgml/logicaldecoding.sgml index ebe0376e3e6..aac72581378 100644 --- a/doc/src/sgml/logicaldecoding.sgml +++ b/doc/src/sgml/logicaldecoding.sgml @@ -326,11 +326,12 @@ postgres=# select * from pg_logical_slot_get_changes('regression_slot', NULL, NU connection is alive (for example a node restart would break it). Then, the primary may delete system catalog rows that could be needed by the logical decoding on the standby (as it does not know about the catalog_xmin on the - standby). Existing logical slots on standby also get invalidated if wal_level - on primary is reduced to less than 'logical'. This is done as soon as the - standby detects such a change in the WAL stream. It means, that for walsenders - that are lagging (if any), some WAL records up to the wal_level parameter change - on the primary won't be decoded. + standby). Existing logical slots on the standby also get invalidated if + wal_level on the primary is reduced to less than + logical. + This is done as soon as the standby detects such a change in the WAL stream. + It means that, for walsenders which are lagging (if any), some WAL records up + to the wal_level parameter change on the primary won't be decoded. @@ -340,7 +341,7 @@ postgres=# select * from pg_logical_slot_get_changes('regression_slot', NULL, NU primary. Thus, slot creation may need to wait for some activity to happen on the primary. If the primary is idle, creating a logical slot on standby may take noticeable time. This can be sped up by calling the - pg_log_standby_snapshot on the primary. + pg_log_standby_snapshot function on the primary. diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml index 3f33a1c56c9..a37331ec524 100644 --- a/doc/src/sgml/monitoring.sgml +++ b/doc/src/sgml/monitoring.sgml @@ -4740,7 +4740,7 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i Number of uses of logical slots in this database that have been - canceled due to old snapshots or a too low + canceled due to old snapshots or too low a on the primary diff --git a/doc/src/sgml/pgbuffercache.sgml b/doc/src/sgml/pgbuffercache.sgml index 43c52e38298..27fdfc67a39 100644 --- a/doc/src/sgml/pgbuffercache.sgml +++ b/doc/src/sgml/pgbuffercache.sgml @@ -214,7 +214,7 @@ buffers_used int4 - Number of unused shared buffers + Number of used shared buffers diff --git a/doc/src/sgml/postgres-fdw.sgml b/doc/src/sgml/postgres-fdw.sgml index 9e66987cf7f..a122794df3c 100644 --- a/doc/src/sgml/postgres-fdw.sgml +++ b/doc/src/sgml/postgres-fdw.sgml @@ -515,7 +515,7 @@ OPTIONS (ADD password_required 'false'); When multiple remote subtransactions are involved in the current local subtransaction, by default postgres_fdw commits or aborts those remote subtransactions serially when the local subtransaction - is committed or abortd. + is committed or aborted. Performance can be improved with the following options: @@ -525,8 +525,8 @@ OPTIONS (ADD password_required 'false'); parallel_commit (boolean) - This option controls whether postgres_fdw commits - in parallel remote transactions opened on a foreign server in a local + This option controls whether postgres_fdw commits, + in parallel, remote transactions opened on a foreign server in a local transaction when the local transaction is committed. This setting also applies to remote and local subtransactions. This option can only be specified for foreign servers, not per-table. The default is diff --git a/doc/src/sgml/ref/create_publication.sgml b/doc/src/sgml/ref/create_publication.sgml index e3e1d04e73a..606aa64ecfa 100644 --- a/doc/src/sgml/ref/create_publication.sgml +++ b/doc/src/sgml/ref/create_publication.sgml @@ -205,7 +205,7 @@ CREATE PUBLICATION name There can be a case where a subscription combines multiple publications. If a partitioned table is published by any subscribed publications which set - publish_via_partition_root = true, changes on this + publish_via_partition_root = true, changes on this partitioned table (or on its partitions) will be published using the identity and schema of this partitioned table rather than that of the individual partitions. diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml index 0e19da90d38..c5c74b86a20 100644 --- a/doc/src/sgml/ref/createuser.sgml +++ b/doc/src/sgml/ref/createuser.sgml @@ -85,7 +85,7 @@ PostgreSQL documentation - Indicates role that will be immediately added as a member of the new + Indicates a role that will be immediately added as a member of the new role with admin option, giving it the right to grant membership in the new role to others. Multiple roles to add as members (with admin option) of the new role can be specified by writing multiple @@ -153,7 +153,7 @@ PostgreSQL documentation - Indicates role to which this role will be added immediately as a new + Indicates a role to which this role will be added immediately as a new member. Multiple roles to which this role will be added as a member can be specified by writing multiple switches. diff --git a/doc/src/sgml/ref/pg_waldump.sgml b/doc/src/sgml/ref/pg_waldump.sgml index 7685d3d15b9..300edc9fc41 100644 --- a/doc/src/sgml/ref/pg_waldump.sgml +++ b/doc/src/sgml/ref/pg_waldump.sgml @@ -295,7 +295,7 @@ PostgreSQL documentation FORK - The name of the fork the full page image came from, as of + The name of the fork the full page image came from, such as _main, _fsm, _vm, or _init. diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml index f4f25d1b076..dc422373d6f 100644 --- a/doc/src/sgml/ref/psql-ref.sgml +++ b/doc/src/sgml/ref/psql-ref.sgml @@ -2903,17 +2903,16 @@ lo_import 152801 full: the expanded header is not truncated, - and will be as wide as the widest output - line. + and will be as wide as the widest output line. - column: truncate the header line at the + column: truncate the header line to the width of the first column. - page: truncate the header line at the terminal + page: truncate the header line to the terminal width. diff --git a/doc/src/sgml/ref/reindex.sgml b/doc/src/sgml/ref/reindex.sgml index c6ad2546f93..71455dfdc79 100644 --- a/doc/src/sgml/ref/reindex.sgml +++ b/doc/src/sgml/ref/reindex.sgml @@ -129,7 +129,7 @@ REINDEX [ ( option [, ...] ) ] { DA Recreate all indexes within the current database, except system catalogs. - Indexes on shared system catalogs are not processed. + Indexes on system catalogs are not processed. This form of REINDEX cannot be executed inside a transaction block. diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml index dbe23db54f0..f3bdc7e87eb 100644 --- a/doc/src/sgml/runtime.sgml +++ b/doc/src/sgml/runtime.sgml @@ -2008,7 +2008,7 @@ pg_dumpall -p 5432 | psql -d postgres -p 5433 sslmode=verify-ca or verify-full and have the appropriate root certificate file installed (). Alternatively the - system CA pool can be used using sslrootcert=system; in + system CA pool can be selected using sslrootcert=system; in this case, sslmode=verify-full is forced for safety, since it is generally trivial to obtain certificates which are signed by a public CA.