docs: fix inconsistencies in markup and case

Ensure to properly mark up function parameters in text with <parameter>,
avoid using <acronym> for terms which aren't acronyms and properly place
the ", and" in a value list. The acronym removal is a follow-up to commit
fb72a7b8c3 which removed it for minmax-multi.  In passing, also fix an
incorrectly cased word.

Author: Ekaterina Kiryanova <e.kiryanova@postgrespro.ru>
Reviewed-by: Laurenz Albe <laurenz.albe@cybertec.at>
Discussion: https://postgr.es/m/c050ecbc-80b2-b360-3c1d-9fe6a6a11bb5@postgrespro.ru
Backpatch-through: v14
This commit is contained in:
Daniel Gustafsson 2021-07-15 23:22:58 +02:00
parent a49d081235
commit 830ef61bd8
4 changed files with 6 additions and 6 deletions

View File

@ -279,7 +279,7 @@ SET client_min_messages = DEBUG1;
<para>
If specified, corruption checking begins at the specified block,
skipping all previous blocks. It is an error to specify a
<literal>startblock</literal> outside the range of blocks in the
<parameter>startblock</parameter> outside the range of blocks in the
target table.
</para>
<para>
@ -293,7 +293,7 @@ SET client_min_messages = DEBUG1;
<para>
If specified, corruption checking ends at the specified block,
skipping all remaining blocks. It is an error to specify an
<literal>endblock</literal> outside the range of blocks in the target
<parameter>endblock</parameter> outside the range of blocks in the target
table.
</para>
<para>

View File

@ -716,7 +716,7 @@ LOG: request for BRIN range summarization for index "brin_wi_idx" page 128 was
</para>
<para>
<acronym>bloom</acronym> operator classes accept these parameters:
bloom operator classes accept these parameters:
</para>
<variablelist>

View File

@ -7393,8 +7393,8 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</replaceable>:<replaceable>&l
An array containing codes for the enabled statistics kinds;
valid values are:
<literal>d</literal> for n-distinct statistics,
<literal>f</literal> for functional dependency statistics, and
<literal>m</literal> for most common values (MCV) list statistics
<literal>f</literal> for functional dependency statistics,
<literal>m</literal> for most common values (MCV) list statistics, and
<literal>e</literal> for expression statistics
</para></entry>
</row>

View File

@ -7017,7 +7017,7 @@ local0.* /var/log/postgresql
</row>
<row>
<entry><literal>%Q</literal></entry>
<entry>query identifier of the current query. Query
<entry>Query identifier of the current query. Query
identifiers are not computed by default, so this field
will be zero unless <xref linkend="guc-compute-query-id"/>
parameter is enabled or a third-party module that computes