From: Alexander Lakhin <exclusion@gmail.com>
To: pgsql-docs@postgresql.org <pgsql-docs@postgresql.org>
Subject: Errors in documentation
Date: Wed, 23 Aug 2017 17:42:09 +0300
Message-ID: <7b769321-bbb1-49aa-2169-db6b82a71960@gmail.com> (raw)
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
Hello,
Please consider committing attached patches to the documentation.
A pair of the patches I sent before (see
https://www.postgresql.org/message-id/374e84e6-f89b-4d0a-652c-cb2449f0bfc4%40gmail.com),
but they weren't committed.
If some of these patches are not valid or raise any questions, please
let me know.
Best
--
Alexander Lakhin
Postgres Professional: http://www.postgrespro.com
The Russian Postgres Company
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docsAttachments:download all (14 files, .tar.gz)alter_table-tags-comma.patch (text/x-patch, 829B) downloaddiff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgmlindex 6960032..dae6307 100644--- a/doc/src/sgml/ref/alter_table.sgml+++ b/doc/src/sgml/ref/alter_table.sgml@@ -620,8 +620,8 @@ ALTER TABLE [ IF EXISTS ] <replaceable class="PARAMETER">name</replaceable>
<literal>SHARE UPDATE EXCLUSIVE</literal> lock will be taken for
fillfactor and autovacuum storage parameters, as well as the
following planner related parameters:
- effective_io_concurrency, parallel_workers, seq_page_cost- random_page_cost, n_distinct and n_distinct_inherited.+ <varname>effective_io_concurrency</>, <varname>parallel_workers</>, <varname>seq_page_cost</>,+ <varname>random_page_cost</>, <varname>n_distinct</> and <varname>n_distinct_inherited</>.
</para>
<note>
are-are.patch (text/x-patch, 1.4K) downloaddiff --git a/doc/src/sgml/ref/alter_sequence.sgml b/doc/src/sgml/ref/alter_sequence.sgmlindex 3a04d07..190c8d6 100644--- a/doc/src/sgml/ref/alter_sequence.sgml+++ b/doc/src/sgml/ref/alter_sequence.sgml@@ -89,7 +89,7 @@ ALTER SEQUENCE [ IF EXISTS ] <replaceable class="parameter">name</replaceable> S
The optional
clause <literal>AS <replaceable class="parameter">data_type</replaceable></literal>
changes the data type of the sequence. Valid types are
- are <literal>smallint</literal>, <literal>integer</literal>,+ <literal>smallint</literal>, <literal>integer</literal>,
and <literal>bigint</literal>.
</para>
diff --git a/doc/src/sgml/ref/create_sequence.sgml b/doc/src/sgml/ref/create_sequence.sgmlindex f1448e7..2af8c8d 100644--- a/doc/src/sgml/ref/create_sequence.sgml+++ b/doc/src/sgml/ref/create_sequence.sgml@@ -119,7 +119,7 @@ SELECT * FROM <replaceable>name</replaceable>;
The optional
clause <literal>AS <replaceable class="parameter">data_type</replaceable></literal>
specifies the data type of the sequence. Valid types are
- are <literal>smallint</literal>, <literal>integer</literal>,+ <literal>smallint</literal>, <literal>integer</literal>,
and <literal>bigint</literal>. <literal>bigint</literal> is the
default. The data type determines the default minimum and maximum
values of the sequence.
catalogs-Name_name.patch (text/x-patch, 500B) downloaddiff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgmlindex ef7054c..3126990 100644--- a/doc/src/sgml/catalogs.sgml+++ b/doc/src/sgml/catalogs.sgml@@ -5385,7 +5385,7 @@ SCRAM-SHA-256$<replaceable><iteration count></>:<replaceable><salt><
<row>
<entry><structfield>pubname</structfield></entry>
- <entry><type>Name</type></entry>+ <entry><type>name</type></entry>
<entry></entry>
<entry>Name of the publication</entry>
</row>
copy-input_insert.patch (text/x-patch, 566B) downloaddiff --git a/doc/src/sgml/ref/copy.sgml b/doc/src/sgml/ref/copy.sgmlindex 8de1150..732efe6 100644--- a/doc/src/sgml/ref/copy.sgml+++ b/doc/src/sgml/ref/copy.sgml@@ -482,7 +482,7 @@ COPY <replaceable class="parameter">count</replaceable>
<para>
For identity columns, the <command>COPY FROM</command> command will always
write the column values provided in the input data, like
- the <command>INPUT</command> option <literal>OVERRIDING SYSTEM+ the <command>INSERT</command> option <literal>OVERRIDING SYSTEM
VALUE</literal>.
</para>
create_table-fix-a-sentence.patch (text/x-patch, 1.1K) downloaddiff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgmlindex e9c2c49..a6ca590 100644--- a/doc/src/sgml/ref/create_table.sgml+++ b/doc/src/sgml/ref/create_table.sgml@@ -473,8 +473,8 @@ FROM ( { <replaceable class="PARAMETER">numeric_literal</replaceable> | <replace
<firstterm>partitioned</firstterm> table. The parenthesized list of
columns or expressions forms the <firstterm>partition key</firstterm>
for the table. When using range partitioning, the partition key can
- include multiple columns or expressions (up to 32, but this limit can- altered when building <productname>PostgreSQL</productname>.), but for+ include multiple columns or expressions (up to 32, but this limit can be+ altered when building <productname>PostgreSQL</productname>), but for
list partitioning, the partition key must consist of a single column or
expression. If no B-tree operator class is specified when creating a
partitioned table, the default B-tree operator class for the datatype will
event-trigger-table.patch (text/x-patch, 529B) downloaddiff --git a/doc/src/sgml/event-trigger.sgml b/doc/src/sgml/event-trigger.sgmlindex 3ed14f0..c7b880d 100644--- a/doc/src/sgml/event-trigger.sgml+++ b/doc/src/sgml/event-trigger.sgml@@ -565,6 +565,7 @@
<entry align="center"><literal>X</literal></entry>
<entry align="center"><literal>-</literal></entry>
<entry align="center"><literal>-</literal></entry>
+ <entry align="center"></entry>
</row>
<row>
<entry align="left"><literal>CREATE USER MAPPING</literal></entry>
failback.patch (text/x-patch, 563B) downloaddiff --git a/doc/src/sgml/release-9.5.sgml b/doc/src/sgml/release-9.5.sgmlindex 14a9b9d..7fd4dee 100644--- a/doc/src/sgml/release-9.5.sgml+++ b/doc/src/sgml/release-9.5.sgml@@ -6918,7 +6918,7 @@ Add GUC and storage parameter to set the maximum size of GIN pending list.
-->
<para>
Add <link linkend="app-pgrewind"><application>pg_rewind</></>,
- which allows re-synchronizing a master server after failback+ which allows re-synchronizing a master server after fallback
(Heikki Linnakangas)
</para>
</listitem>
indexam-structname.patch (text/x-patch, 769B) downloaddiff --git a/doc/src/sgml/indexam.sgml b/doc/src/sgml/indexam.sgmlindex ac51258..aa3d371 100644--- a/doc/src/sgml/indexam.sgml+++ b/doc/src/sgml/indexam.sgml@@ -559,7 +559,7 @@ amgettuple (IndexScanDesc scan,
a <structname>HeapTuple</> pointer stored at <literal>scan->xs_hitup</>,
with tuple descriptor <literal>scan->xs_hitupdesc</>. (The latter
format should be used when reconstructing data that might possibly not fit
- into an IndexTuple.) In either case,+ into an <structname>IndexTuple</>.) In either case,
management of the data referenced by the pointer is the access method's
responsibility. The data must remain good at least until the next
<function>amgettuple</>, <function>amrescan</>, or <function>amendscan</>
logicaldecoding-pg_stat_replication-link.patch (text/x-patch, 795B) downloaddiff --git a/doc/src/sgml/logicaldecoding.sgml b/doc/src/sgml/logicaldecoding.sgmlindex 8dcfc6c..a979913 100644--- a/doc/src/sgml/logicaldecoding.sgml+++ b/doc/src/sgml/logicaldecoding.sgml@@ -345,7 +345,7 @@ $ pg_recvlogical -d postgres --slot test --drop-slot
<para>
The <link linkend="view-pg-replication-slots"><structname>pg_replication_slots</structname></link>
view and the
- <link linkend="monitoring-stats-views-table"><structname>pg_stat_replication</structname></link>+ <link linkend="pg-stat-replication-view"><structname>pg_stat_replication</structname></link>
view provide information about the current state of replication slots and
streaming replication connections respectively. These views apply to both physical and
logical replication.
perform-space.patch (text/x-patch, 589B) downloaddiff --git a/doc/src/sgml/perform.sgml b/doc/src/sgml/perform.sgmlindex 924f609..1346328 100644--- a/doc/src/sgml/perform.sgml+++ b/doc/src/sgml/perform.sgml@@ -1840,7 +1840,7 @@ SELECT * FROM x, y, a, b, c WHERE something AND somethingelse;
<listitem>
<para>
Increase <xref linkend="guc-max-wal-size"> and <xref
- linkend="guc-checkpoint-timeout"> ; this reduces the frequency+ linkend="guc-checkpoint-timeout">; this reduces the frequency
of checkpoints, but increases the storage requirements of
<filename>/pg_wal</>.
</para>
readded.patch (text/x-patch, 1.2K) downloaddiff --git a/doc/src/sgml/release-7.4.sgml b/doc/src/sgml/release-7.4.sgmlindex 1ddab66..88578dc 100644--- a/doc/src/sgml/release-7.4.sgml+++ b/doc/src/sgml/release-7.4.sgml@@ -4254,7 +4254,7 @@ DROP SCHEMA information_schema CASCADE;
The Python language no longer supports a restricted execution
environment, so the trusted version of PL/Python was removed. If
this situation changes, a version of PL/Python that can be used
- by non-superusers will be readded.+ by non-superusers will be read.
</para>
</listitem>
diff --git a/src/bin/pg_dump/pg_dump.c b/src/bin/pg_dump/pg_dump.cindex b26358c..c2eaa11 100644--- a/src/bin/pg_dump/pg_dump.c+++ b/src/bin/pg_dump/pg_dump.c@@ -9595,7 +9595,7 @@ dumpExtension(Archive *fout, ExtensionInfo *extinfo)
/*
* We unconditionally create the extension, so we must drop it if it
* exists. This could happen if the user deleted 'plpgsql' and then
- * readded it, causing its oid to be greater than g_last_builtin_oid.+ * read it, causing its oid to be greater than g_last_builtin_oid.
* The g_last_builtin_oid test was kept to avoid repeatedly dropping
* and recreating extensions like 'plpgsql'.
*/
release-10-misplaced-comma.patch (text/x-patch, 429B) downloaddiff --git a/doc/src/sgml/release-10.sgml b/doc/src/sgml/release-10.sgmlindex 269f1aa..bb85071 100644--- a/doc/src/sgml/release-10.sgml+++ b/doc/src/sgml/release-10.sgml@@ -2882,7 +2882,7 @@
</para>
<para>
- Previously <application>Jade</>, <acronym>DSSSL,</> and+ Previously <application>Jade</>, <acronym>DSSSL</>, and
<application>JadeTex</> were used.
</para>
</listitem>
release-10-one-man.patch (text/x-patch, 410B) downloaddiff --git a/doc/src/sgml/release-10.sgml b/doc/src/sgml/release-10.sgmlindex 269f1aa..640f877 100644--- a/doc/src/sgml/release-10.sgml+++ b/doc/src/sgml/release-10.sgml@@ -2868,7 +2868,7 @@
-->
<para>
Overhaul documentation <link linkend="docguide-toolsets">build
- process</> (Alexander Lakhin, Alexander Law)+ process</> (Alexander Lakhin)
</para>
</listitem>
updateable.patch (text/x-patch, 2.5K) downloaddiff --git a/doc/src/sgml/release-7.4.sgml b/doc/src/sgml/release-7.4.sgmlindex bc4f4e1..1ddab66 100644--- a/doc/src/sgml/release-7.4.sgml+++ b/doc/src/sgml/release-7.4.sgml@@ -4506,7 +4506,7 @@ DROP SCHEMA information_schema CASCADE;
<title>JDBC Changes</title>
<itemizedlist>
- <listitem><para>Allow <function>setNull</function> on updateable result sets</para></listitem>+ <listitem><para>Allow <function>setNull</function> on updatable result sets</para></listitem>
<listitem><para>Allow <function>executeBatch</function> on a prepared statement (Barry)</para></listitem>
<listitem><para>Support SSL connections (Barry)</para></listitem>
<listitem><para>Handle schema names in result sets (Paul Sorenson)</para></listitem>
diff --git a/doc/src/sgml/release-old.sgml b/doc/src/sgml/release-old.sgmlindex d4de6b1..625874c 100644--- a/doc/src/sgml/release-old.sgml+++ b/doc/src/sgml/release-old.sgml@@ -1228,7 +1228,7 @@ operations on bytea columns (Joe)</para></listitem>
<listitem><para>plpython used wrong value of <envar>atttypmod</envar> (Brad McLean)</para></listitem>
<listitem><para>Fix improper quoting of boolean values in Python interface (D'Arcy)</para></listitem>
<listitem><para>Added <function>addDataType()</function> method to PGConnection interface for JDBC</para></listitem>
-<listitem><para>Fixed various problems with updateable ResultSets for JDBC (Shawn Green)</para></listitem>+<listitem><para>Fixed various problems with updatable ResultSets for JDBC (Shawn Green)</para></listitem>
<listitem><para>Fixed various problems with DatabaseMetaData for JDBC (Kris Jurka, Peter Royal)</para></listitem>
<listitem><para>Fixed problem with parsing table ACLs in JDBC</para></listitem>
<listitem><para>Better error message for character set conversion problems in JDBC</para></listitem>
@@ -1874,7 +1874,7 @@ operations on bytea columns (Joe)</para></listitem>
<listitem><para>Add JDBC 3 support (Barry)</para></listitem>
<listitem><para>Allows JDBC to set loglevel by adding ?loglevel=X to the connection URL (Barry)</para></listitem>
<listitem><para>Add Driver.info() message that prints out the version number (Barry)</para></listitem>
-<listitem><para>Add updateable result sets (Raghu Nidagal, Dave)</para></listitem>+<listitem><para>Add updatable result sets (Raghu Nidagal, Dave)</para></listitem>
<listitem><para>Add support for callable statements (Paul Bethe)</para></listitem>
<listitem><para>Add query cancel capability</para></listitem>
<listitem><para>Add refresh row (Dave)</para></listitem>
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: exclusion@gmail.com
Subject: Re: Errors in documentation
In-Reply-To: <7b769321-bbb1-49aa-2169-db6b82a71960@gmail.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox