Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commita978565

Browse files
committed
doc: wording improvements
Discussion:https://postgr.es/m/a5180360-ec04-ac58-25ce-3d795d3d1f6c@postgrespro.ruAuthor: Ekaterina KiryanovaBackpatch-through: master
1 parent5ae2087 commita978565

13 files changed

+35
-29
lines changed

‎doc/src/sgml/charset.sgml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -293,10 +293,10 @@ initdb --locale=sv_SE
293293
<para>
294294
As explained above, the environment of the operating system provides the
295295
defaults for the locales of a newly initialized database cluster. In
296-
many cases, this is enough:If the operating system is configured for
297-
the desired language/territory,then
298-
<productname>PostgreSQL</productname> willby defaultalso behave
299-
accordingto that locale.
296+
many cases, this is enough:if the operating system is configured for
297+
the desired language/territory,by default
298+
<productname>PostgreSQL</productname> will also behave according
299+
to that locale.
300300
</para>
301301
</listitem>
302302

‎doc/src/sgml/config.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9041,7 +9041,7 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
90419041
<para>
90429042
The timeout is measured from the time a command arrives at the
90439043
server until it is completed by the server. If multiple SQL
9044-
statements appear in a single simple-Query message, the timeout
9044+
statements appear in a single simple-query message, the timeout
90459045
is applied to each statement separately.
90469046
(<productname>PostgreSQL</productname> versions before 13 usually
90479047
treated the timeout as applying to the whole query string.)

‎doc/src/sgml/high-availability.sgml

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1359,8 +1359,8 @@ synchronous_standby_names = 'ANY 2 (s1, s2, s3)'
13591359

13601360
<para>
13611361
If you need to re-create a standby server while transactions are
1362-
waiting, make sure that thecommandspg_backup_start() and
1363-
pg_backup_stop() are run in a session with
1362+
waiting, make sure that thefunctions <function>pg_backup_start()</function>
1363+
and <function>pg_backup_stop()</function> are run in a session with
13641364
<varname>synchronous_commit</varname> = <literal>off</literal>, otherwise those
13651365
requests will wait forever for the standby to appear.
13661366
</para>
@@ -2219,10 +2219,11 @@ HINT: You can then restart the server after making the necessary configuration
22192219
The cumulative statistics system is active during recovery. All scans,
22202220
reads, blocks, index usage, etc., will be recorded normally on the
22212221
standby. However, WAL replay will not increment relation and database
2222-
specific counters. I.e. replay will not increment pg_stat_all_tables
2223-
columns (like n_tup_ins), nor will reads or writes performed by the
2224-
startup process be tracked in the pg_statio views, nor will associated
2225-
pg_stat_database columns be incremented.
2222+
specific counters. I.e. replay will not increment
2223+
<structname>pg_stat_all_tables</structname> columns (like <structfield>n_tup_ins</structfield>),
2224+
nor will reads or writes performed by the startup process be tracked in the
2225+
<structname>pg_statio_</structname> views, nor will associated
2226+
<structname>pg_stat_database</structname> columns be incremented.
22262227
</para>
22272228

22282229
<para>

‎doc/src/sgml/indices.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -754,7 +754,7 @@ CREATE INDEX people_names ON people ((first_name || ' ' || last_name));
754754
<para>
755755
Index expressions are relatively expensive to maintain, because the
756756
derived expression(s) must be computed for each row insertion
757-
and <link linkend="storage-hot">non-HOT update.</link> However, the index expressions are
757+
and <link linkend="storage-hot">non-HOT update</link>. However, the index expressions are
758758
<emphasis>not</emphasis> recomputed during an indexed search, since they are
759759
already stored in the index. In both examples above, the system
760760
sees the query as just <literal>WHERE indexedcolumn = 'constant'</literal>

‎doc/src/sgml/logicaldecoding.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -144,7 +144,7 @@ postgres=# SELECT pg_drop_replication_slot('regression_slot');
144144
</programlisting>
145145

146146
<para>
147-
The following examplesshows how logical decoding is controlled over the
147+
The following examplesshow how logical decoding is controlled over the
148148
streaming replication protocol, using the
149149
program <xref linkend="app-pgrecvlogical"/> included in the PostgreSQL
150150
distribution. This requires that client authentication is set up to allow

‎doc/src/sgml/monitoring.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -261,7 +261,7 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
261261
unnecessary and can be avoided by setting
262262
<varname>stats_fetch_consistency</varname> to <literal>none</literal>.
263263

264-
You can invoke <function>pg_stat_clear_snapshot</function>() to discard the
264+
You can invoke <function>pg_stat_clear_snapshot()</function> to discard the
265265
current transaction's statistics snapshot or cached values (if any). The
266266
next use of statistical information will (when in snapshot mode) cause a
267267
new snapshot to be built or (when in cache mode) accessed statistics to be

‎doc/src/sgml/ref/merge.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -381,9 +381,9 @@ DELETE
381381
An expression to assign to the column. If used in a
382382
<literal>WHEN MATCHED</literal> clause, the expression can use values
383383
from the original row in the target table, and values from the
384-
<literal>data_source</literal> row.
384+
<replaceable>data_source</replaceable> row.
385385
If used in a <literal>WHEN NOT MATCHED</literal> clause, the
386-
expression can use values from the <literal>data_source</literal>.
386+
expression can use values from the <replaceable>data_source</replaceable>.
387387
</para>
388388
</listitem>
389389
</varlistentry>

‎doc/src/sgml/ref/pg_basebackup.sgml

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -422,8 +422,9 @@ PostgreSQL documentation
422422
A compression detail string can optionally be specified.
423423
If the detail string is an integer, it specifies the compression
424424
level. Otherwise, it should be a comma-separated list of items,
425-
each of the form <literal>keyword</literal> or
426-
<literal>keyword=value</literal>.
425+
each of the form
426+
<replaceable>keyword</replaceable> or
427+
<replaceable>keyword=value</replaceable>.
427428
Currently, the supported keywords are <literal>level</literal>,
428429
<literal>long</literal>, and <literal>workers</literal>.
429430
The detail string cannot be used when the compression method
@@ -1019,7 +1020,7 @@ PostgreSQL documentation
10191020
</screen></para>
10201021

10211022
<para>
1022-
To create a backup ofa local server with one tar file for each tablespace
1023+
To create a backup ofthe local server with one tar file for each tablespace
10231024
compressed with <application>gzip</application> at level 9, stored in the
10241025
directory <filename>backup</filename>:
10251026
<screen>

‎doc/src/sgml/ref/pg_receivewal.sgml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -281,7 +281,8 @@ PostgreSQL documentation
281281
A compression detail string can optionally be specified. If the
282282
detail string is an integer, it specifies the compression level.
283283
Otherwise, it should be a comma-separated list of items, each of the
284-
form <literal>keyword</literal> or <literal>keyword=value</literal>.
284+
form <replaceable>keyword</replaceable> or
285+
<replaceable>keyword=value</replaceable>.
285286
Currently, the only supported keyword is <literal>level</literal>.
286287
</para>
287288
<para>

‎doc/src/sgml/ref/pg_recvlogical.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -274,7 +274,7 @@ PostgreSQL documentation
274274
<listitem>
275275
<para>
276276
Enables decoding of prepared transactions. This option may only be specified with
277-
<option>--create-slot</option>
277+
<option>--create-slot</option>.
278278
</para>
279279
</listitem>
280280
</varlistentry>

‎doc/src/sgml/ref/pg_restore.sgml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -659,7 +659,7 @@ PostgreSQL documentation
659659
<para>
660660
Do not output commands to select table access methods.
661661
With this option, all objects will be created with whichever
662-
access method is the default during restore.
662+
tableaccess method is the default during restore.
663663
</para>
664664
</listitem>
665665
</varlistentry>

‎doc/src/sgml/ref/pg_waldump.sgml

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -117,7 +117,7 @@ PostgreSQL documentation
117117
<term><option>--fork=<replaceable>fork</replaceable></option></term>
118118
<listitem>
119119
<para>
120-
If provided, only display records that modify blocks in the given fork.
120+
Only display records that modify blocks in the given fork.
121121
The valid values are <literal>main</literal> for the main fork,
122122
<literal>fsm</literal> for the free space map,
123123
<literal>vm</literal> for the visibility map,
@@ -174,12 +174,13 @@ PostgreSQL documentation
174174
names, and exit.
175175
</para>
176176
<para>
177-
Extensions may define custom resource managers, but pg_waldump does
177+
Extensions may define custom resource managers, but
178+
<application>pg_waldump</application> does
178179
not load the extension module and therefore does not recognize custom
179180
resource managers by name. Instead, you can specify the custom
180181
resource managers as <literal>custom###</literal> where
181-
"<literal>###</literal>" is the three-digit resource manager ID. Names
182-
of this form will always be considered valid.
182+
<replaceable>###</replaceable> is the three-digit resource manager ID.
183+
Namesof this form will always be considered valid.
183184
</para>
184185
</listitem>
185186
</varlistentry>

‎doc/src/sgml/ref/pgbench.sgml

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -229,7 +229,8 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>d
229229
data is generated in <command>pgbench</command> client and then
230230
sent to the server. This uses the client/server bandwidth
231231
extensively through a <command>COPY</command>.
232-
<command>pgbench</command> uses the FREEZE option with version 14 or later
232+
<command>pgbench</command> uses the <option>FREEZE</option> option
233+
with version 14 or later
233234
of <productname>PostgreSQL</productname> to speed up
234235
subsequent <command>VACUUM</command>, except on the
235236
<literal>pgbench_accounts</literal> table if partitions are
@@ -1118,7 +1119,8 @@ pgbench <optional> <replaceable>options</replaceable> </optional> <replaceable>d
11181119
each SQL command on a single line ending with a semicolon.
11191120
</para>
11201121
<para>
1121-
It is assumed that pgbench scripts do not contain incomplete blocks of SQL
1122+
It is assumed that <application>pgbench</application> scripts do not contain
1123+
incomplete blocks of SQL
11221124
transactions. If at runtime the client reaches the end of the script without
11231125
completing the last transaction block, it will be aborted.
11241126
</para>
@@ -2636,7 +2638,7 @@ END;
26362638
</para>
26372639

26382640
<para>
2639-
Here is some example output generated withthese options:
2641+
Here is some example output generated withthis option:
26402642
<screen>
26412643
<userinput>pgbench --aggregate-interval=10 --time=20 --client=10 --log --rate=1000 --latency-limit=10 --failures-detailed --max-tries=10 test</userinput>
26422644

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp