docs: fix inconsistencies in markup and case

Ensure to properly mark up function parameters in text with ,
avoid using  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 
Reviewed-by: Laurenz Albe 
Discussion: https://postgr.es/m/c050ecbc-80b2-b360-3c1d-9fe6a6a11bb5@postgrespro.ru
Backpatch-through: v14

diff --git a/doc/src/sgml/amcheck.sgml b/doc/src/sgml/amcheck.sgml
index a2571d33ae67d61724eb384afb00e3d3580a242a..c570690b59c5783295143f83f6ea00c99e5c0b4f 100644 (file)
--- a/doc/src/sgml/amcheck.sgml
+++ b/doc/src/sgml/amcheck.sgml
@@ -279,7 +279,7 @@ SET client_min_messages = DEBUG1;
         
          If specified, corruption checking begins at the specified block,
          skipping all previous blocks.  It is an error to specify a
-         <literal>startblock> outside the range of blocks in the
+         <parameter>startblock> outside the range of blocks in the
          target table.
         
         
@@ -293,7 +293,7 @@ SET client_min_messages = DEBUG1;
         
          If specified, corruption checking ends at the specified block,
          skipping all remaining blocks.  It is an error to specify an
-         <literal>endblock> outside the range of blocks in the target
+         <parameter>endblock> outside the range of blocks in the target
          table.
         
         

diff --git a/doc/src/sgml/brin.sgml b/doc/src/sgml/brin.sgml
index 39c01dc68085671deeefd306d8a2285ce4ab5e7e..caf1ea4cef109e6073c3ee0d94cc538cbec4454f 100644 (file)
--- a/doc/src/sgml/brin.sgml
+++ b/doc/src/sgml/brin.sgml
@@ -716,7 +716,7 @@ LOG:  request for BRIN range summarization for index "brin_wi_idx" page 128 was
    
 
    
-    bloom operator classes accept these parameters:
+    bloom operator classes accept these parameters:
    
 
    

diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml
index 5128f34d40732e76b654254b5064c6317719da2f..2b2c70a26e5397a001274c30523c6a69812892ef 100644 (file)
--- a/doc/src/sgml/catalogs.sgml
+++ b/doc/src/sgml/catalogs.sgml
@@ -7393,8 +7393,8 @@ SCRAM-SHA-256$<iteration count>:&l
        An array containing codes for the enabled statistics kinds;
        valid values are:
        d for n-distinct statistics,
-       f for functional dependency statistics, and
-       m for most common values (MCV) list statistics
+       f for functional dependency statistics,
+       m for most common values (MCV) list statistics, and
        e for expression statistics
       
      

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 43772c2a980472096290756c03bd1dea20ac5666..a23ae67ba52bdce3f2c5bf8149bef572a53834d7 100644 (file)
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -7017,7 +7017,7 @@ local0.*    /var/log/postgresql
             
             
              %Q
-             query identifier of the current query.  Query
+             Query identifier of the current query.  Query
              identifiers are not computed by default, so this field
              will be zero unless 
              parameter is enabled or a third-party module that computes