mirror of
https://github.com/postgres/postgres.git
synced 2025-12-22 17:42:17 +03:00
Fix various typos, grammar and code style in comments and docs
This fixes a set of issues that have accumulated over the past months (or years) in various code areas. Most fixes are related to some recent additions, as of the development of v15. Author: Justin Pryzby Discussion: https://postgr.es/m/20220124030001.GQ23027@telsasoft.com
This commit is contained in:
@@ -50,7 +50,7 @@ ALTER PUBLICATION <replaceable class="parameter">name</replaceable> RENAME TO <r
|
||||
tables/schemas that were present in the publication will be removed. The
|
||||
<literal>ADD</literal> and <literal>DROP</literal> clauses will add and
|
||||
remove one or more tables/schemas from the publication. Note that adding
|
||||
tables/schemas to a publication that is already subscribed to will require a
|
||||
tables/schemas to a publication that is already subscribed to will require an
|
||||
<literal>ALTER SUBSCRIPTION ... REFRESH PUBLICATION</literal> action on the
|
||||
subscribing side in order to become effective.
|
||||
</para>
|
||||
@@ -82,7 +82,7 @@ ALTER PUBLICATION <replaceable class="parameter">name</replaceable> RENAME TO <r
|
||||
<para>
|
||||
Adding/Setting a table that is part of schema specified in
|
||||
<literal>ALL TABLES IN SCHEMA</literal>, adding/setting a schema to a
|
||||
publication that already has a table that is part of specified schema or
|
||||
publication that already has a table that is part of the specified schema or
|
||||
adding/setting a table to a publication that already has a table's schema as
|
||||
part of the specified schema is not supported.
|
||||
</para>
|
||||
|
||||
@@ -131,9 +131,9 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
|
||||
|
||||
<para>
|
||||
When a partitioned table is published via schema level publication, all
|
||||
of its existing and future partitions irrespective of it being from the
|
||||
publication schema or not are implicitly considered to be part of the
|
||||
publication. So, even operations that are performed directly on a
|
||||
of its existing and future partitions are implicitly considered to be part of the
|
||||
publication, regardless of whether they are from the publication schema or not.
|
||||
So, even operations that are performed directly on a
|
||||
partition are also published via publications that its ancestors are
|
||||
part of.
|
||||
</para>
|
||||
@@ -195,7 +195,7 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
|
||||
|
||||
<para>
|
||||
If <literal>FOR TABLE</literal>, <literal>FOR ALL TABLES</literal> or
|
||||
<literal>FOR ALL TABLES IN SCHEMA</literal> is not specified, then the
|
||||
<literal>FOR ALL TABLES IN SCHEMA</literal> are not specified, then the
|
||||
publication starts out with an empty set of tables. That is useful if
|
||||
tables or schemas are to be added later.
|
||||
</para>
|
||||
|
||||
@@ -82,9 +82,8 @@ PostgreSQL documentation
|
||||
<listitem>
|
||||
<para>
|
||||
First, scan the directory where the WAL segment files are written and
|
||||
find the newest completed segment file, using as starting point the
|
||||
beginning of the next WAL segment file. This is calculated independently
|
||||
on the compression method used to compress each segment.
|
||||
find the newest completed segment file, using as the starting point the
|
||||
beginning of the next WAL segment file.
|
||||
</para>
|
||||
</listitem>
|
||||
|
||||
@@ -93,7 +92,7 @@ PostgreSQL documentation
|
||||
If a starting point cannot be calculated with the previous method,
|
||||
and if a replication slot is used, an extra
|
||||
<command>READ_REPLICATION_SLOT</command> command is issued to retrieve
|
||||
the slot's <literal>restart_lsn</literal> to use as starting point.
|
||||
the slot's <literal>restart_lsn</literal> to use as the starting point.
|
||||
This option is only available when streaming write-ahead logs from
|
||||
<productname>PostgreSQL</productname> 15 and up.
|
||||
</para>
|
||||
@@ -103,7 +102,7 @@ PostgreSQL documentation
|
||||
<para>
|
||||
If a starting point cannot be calculated with the previous method,
|
||||
the latest WAL flush location is used as reported by the server from
|
||||
a <literal>IDENTIFY_SYSTEM</literal> command.
|
||||
an <literal>IDENTIFY_SYSTEM</literal> command.
|
||||
</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
@@ -268,7 +267,7 @@ PostgreSQL documentation
|
||||
<listitem>
|
||||
<para>
|
||||
Enables compression of write-ahead logs using the specified method.
|
||||
Supported values <literal>gzip</literal>, <literal>lz4</literal>
|
||||
Supported values are <literal>gzip</literal>, <literal>lz4</literal>
|
||||
(if <productname>PostgreSQL</productname> was compiled with
|
||||
<option>--with-lz4</option>), and <literal>none</literal>.
|
||||
</para>
|
||||
|
||||
@@ -220,8 +220,8 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>d
|
||||
data is generated in <command>pgbench</command> client and then
|
||||
sent to the server. This uses the client/server bandwidth
|
||||
extensively through a <command>COPY</command>.
|
||||
<command>pgbench</command> uses the FREEZE option with 14 or later
|
||||
versions of <productname>PostgreSQL</productname> to speed up
|
||||
<command>pgbench</command> uses the FREEZE option with version 14 or later
|
||||
of <productname>PostgreSQL</productname> to speed up
|
||||
subsequent <command>VACUUM</command>, unless partitions are enabled.
|
||||
Using <literal>g</literal> causes logging to print one message
|
||||
every 100,000 rows while generating data for the
|
||||
|
||||
@@ -139,7 +139,7 @@ PostgreSQL documentation
|
||||
of the upgraded cluster to be written safely to disk. This option
|
||||
causes <command>pg_upgrade</command> to return without waiting, which
|
||||
is faster, but means that a subsequent operating system crash can leave
|
||||
the synchronized data directory corrupt. Generally, this option is
|
||||
the data directory corrupt. Generally, this option is
|
||||
useful for testing but should not be used on a production
|
||||
installation.
|
||||
</para>
|
||||
|
||||
@@ -107,7 +107,7 @@ SELECT [ ALL | DISTINCT [ ON ( <replaceable class="parameter">expression</replac
|
||||
|
||||
<para>
|
||||
In contrast to <command>CREATE TABLE AS</command>, <command>SELECT
|
||||
INTO</command> does not allow to specify properties like a table's access
|
||||
INTO</command> does not allow specifying properties like a table's access
|
||||
method with <xref linkend="sql-createtable-method" /> or the table's
|
||||
tablespace with <xref linkend="sql-createtable-tablespace" />. Use
|
||||
<command>CREATE TABLE AS</command> if necessary. Therefore, the default table
|
||||
|
||||
Reference in New Issue
Block a user