pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
Errors in documentation
2+ messages / 2 participants
[nested] [flat]

* Errors in documentation
@ 2017-08-23 14:42 Alexander Lakhin <exclusion@gmail.com>
  2017-09-02 03:40 ` Re: Errors in documentation Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
  0 siblings, 1 reply; 2+ messages in thread

From: Alexander Lakhin @ 2017-08-23 14:42 UTC (permalink / raw)
  To: pgsql-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-docs

Attachments: download all (14 files, .tar.gz)

alter_table-tags-comma.patch (text/x-patch, 829B) download diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml index 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) download diff --git a/doc/src/sgml/ref/alter_sequence.sgml b/doc/src/sgml/ref/alter_sequence.sgml index 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.sgml index 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) download diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml index ef7054c..3126990 100644 --- a/doc/src/sgml/catalogs.sgml +++ b/doc/src/sgml/catalogs.sgml @@ -5385,7 +5385,7 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</>:<replaceable>&lt;salt&gt;< <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) download diff --git a/doc/src/sgml/ref/copy.sgml b/doc/src/sgml/ref/copy.sgml index 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) download diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml index 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) download diff --git a/doc/src/sgml/event-trigger.sgml b/doc/src/sgml/event-trigger.sgml index 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) download diff --git a/doc/src/sgml/release-9.5.sgml b/doc/src/sgml/release-9.5.sgml index 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) download diff --git a/doc/src/sgml/indexam.sgml b/doc/src/sgml/indexam.sgml index 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-&gt;xs_hitup</>, with tuple descriptor <literal>scan-&gt;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) download diff --git a/doc/src/sgml/logicaldecoding.sgml b/doc/src/sgml/logicaldecoding.sgml index 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) download diff --git a/doc/src/sgml/perform.sgml b/doc/src/sgml/perform.sgml index 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) download diff --git a/doc/src/sgml/release-7.4.sgml b/doc/src/sgml/release-7.4.sgml index 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.c index 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) download diff --git a/doc/src/sgml/release-10.sgml b/doc/src/sgml/release-10.sgml index 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) download diff --git a/doc/src/sgml/release-10.sgml b/doc/src/sgml/release-10.sgml index 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) download diff --git a/doc/src/sgml/release-7.4.sgml b/doc/src/sgml/release-7.4.sgml index 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.sgml index 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>
^ permalink raw reply [nested|flat] 2+ messages in thread

* Re: Errors in documentation
  2017-08-23 14:42 Errors in documentation Alexander Lakhin <exclusion@gmail.com>
@ 2017-09-02 03:40 ` Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
  0 siblings, 0 replies; 2+ messages in thread

From: Peter Eisentraut @ 2017-09-02 03:40 UTC (permalink / raw)
  To: Alexander Lakhin <exclusion@gmail.com>; pgsql-docs

On 8/23/17 10:42, Alexander Lakhin wrote:
> 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.

I have committed these patches, except the "readded" and "failback"
patches, which were incorrect, and the changes to very old release
notes, which we typically don't change.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services


-- 
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs



^ permalink  raw  reply  [nested|flat] 2+ messages in thread


end of thread, other threads:[~2017-09-02 03:40 UTC | newest]

Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2017-08-23 14:42 Errors in documentation Alexander Lakhin <exclusion@gmail.com>
2017-09-02 03:40 ` Peter Eisentraut <peter.eisentraut@2ndquadrant.com>

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