Commit Graph

16683 Commits

Author SHA1 Message Date
Bruce Momjian 527c3c1bec doc: fix link to ALTER GROUP
Fix for commit 2882d1f31a.

Reported-by: Tom Lane

Discussion: https://postgr.es/m/1388368.1696011440@sss.pgh.pa.us

Backpatch-through: 16 only
2023-09-29 14:32:16 -04:00
Bruce Momjian 2882d1f31a doc: PG 16 relnotes: change GRANT GROUP item to ALTER GROUP
Reported-by: TAKATSUKA Haruka

Discussion: https://postgr.es/m/18137-866ccb684317745f@postgresql.org

Backpatch-through: 16 only
2023-09-29 14:16:17 -04:00
Tom Lane 19bc6fda8b Doc: improve description of dump/restore's --clean and --if-exists.
Try to make these option descriptions a little clearer for novices.
Per gripe from Attila Gulyás.

Discussion: https://postgr.es/m/169590536647.3727336.11070254203649648453@wrigleys.postgresql.org
2023-09-29 13:13:54 -04:00
Daniel Gustafsson 2e5cc553a8 doc: Change statistics function xref to the right target
Commit 7d3b7011b added a link to the statistics functions, which at the
time were anchored under the section for statistics views.  aebe989477
added a separate section for statistics functions, but the link was not
updated to point to the new anchor.  Fix by changing the xref.

Backpatch to all supported branches.

Author: Peter Smith <peter.b.smith@fujitsu.com>
Discussion: https://postgr.es/m/CAHut+Ptr0jKzNNtWnssLq+3jNhbyaBseqf6NPrWHk08mQFRoTg@mail.gmail.com
Backpatch-through: 11
2023-09-29 15:55:37 +02:00
Michael Paquier 950e236e50 doc: Fix descriptions related to the handling of non-ASCII characters
Since 45b1a67a0f, non-printable ASCII characters do not show up in
various configuration paths as question marks, but as hexadecimal
escapes.  The documentation was not updated to reflect that.

Author: Hayato Kuroda
Reviewed-by: Jian He, Tom Lane, Karl O. Pinc, Peter Smith
Discussion: https://postgr.es/m/TYAPR01MB586631D0961BF9C44893FAB1F523A@TYAPR01MB5866.jpnprd01.prod.outlook.com
Backpatch-through: 16
2023-09-29 10:34:18 +09:00
Bruce Momjian 2ef5c5e736 doc: clarify the effect of concurrent work_mem allocations
Reported-by: Sami Imseih

Discussion: https://postgr.es/m/66590882-F48C-4A25-83E3-73792CF8C51F@amazon.com

Backpatch-through: 11
2023-09-26 19:44:22 -04:00
Bruce Momjian 430f4497b0 doc: clarify handling of time zones with "time with time zone"
Reported-by: davecramer@postgres.rocks

Discussion: https://postgr.es/m/168451942371.714.9173574930845904336@wrigleys.postgresql.org

Backpatch-through: 11
2023-09-26 19:23:59 -04:00
Bruce Momjian 362b94d02a doc: clarify the behavior of unopenable listen_addresses
Reported-by: Gurjeet Singh

Discussion: https://postgr.es/m/CABwTF4WYPD9ov-kcSq1+J+ZJ5wYDQLXquY6Lu2cvb-Y7pTpSGA@mail.gmail.com

Backpatch-through: 11
2023-09-26 19:02:18 -04:00
Bruce Momjian b21ec201c0 doc: pg_upgrade, clarify standby servers must remain running
Also mention that mismatching primary/standby LSNs should never
happen.

Reported-by: Nikolay Samokhvalov

Discussion: https://postgr.es/m/CAM527d8heqkjG5VrvjU3Xjsqxg41ufUyabD9QZccdAxnpbRH-Q@mail.gmail.com

Backpatch-through: 11
2023-09-26 18:54:10 -04:00
Bruce Momjian 17cd48de3c doc: mention GROUP BY columns can reference target col numbers
Reported-by: hape <postgres-hape@gmx.de>

Discussion: https://postgr.es/m/168871536004.379168.9352636188330923805@wrigleys.postgresql.org

Backpatch-through: 11
2023-09-26 17:31:06 -04:00
Bruce Momjian e391939b76 doc: PG 16 relnotes: clarify "relation" segsize mention
Reported-by: harukat@sraoss.co.jp

Discussion: https://postgr.es/m/18124-d363fa4873e176d6@postgresql.org

Backpatch-through: 16 only
2023-09-26 12:08:49 -04:00
Michael Paquier b7f92b1150 doc: Tell about "vcregress taptest" for regression tests on Windows
There was no mention of this command in the documentation, and it is
useful to run the TAP tests of a target source directory.

Author: Yugo Nagata
Discussion: https://postgr.es/m/20230925153204.926d685d347ee1c8f527090c@sraoss.co.jp
Backpatch-through: 11
2023-09-26 08:16:41 +09:00
Andres Freund 72bf3f0877 docs: Clarify --with-segsize-blocks documentation
Without the added "relation" it's not immediately clear that the option
relates to the relation segment size and not e.g. the WAL segment size.

The option was added in d3b111e32.

Reported-by: Tom Lane <tgl@sss.pgh.pa.us>
Discussion: https://postgr.es/m/837536.1695348498@sss.pgh.pa.us
Backpatch: 16-
2023-09-25 10:42:19 -07:00
Tom Lane 2290a13827 Doc: copy-edit the introductory para for the pg_class catalog.
The previous wording had a faint archaic whiff to it, and more
importantly used "catalogs" as a verb, which while cutely
self-referential seems likely to provoke confusion in this
particular context.  Also consistently use "kind" not "type" to
refer to the different kinds of relations distinguished by relkind.

Per gripe from Martin Nash.  Back-patch to supported versions.

Discussion: https://postgr.es/m/169518739902.3727338.4793815593763320945@wrigleys.postgresql.org
2023-09-22 14:52:36 -04:00
Bruce Momjian dce4544414 doc: PG 16 relnotes: improve wording of promote_trigger item
Reported-by: Dave Page

Author: Dave Page

Backpatch-through: 16 only
2023-09-21 11:27:29 -04:00
Michael Paquier 3701db77a0 doc: Fix description of BUFFER_USAGE_LIMIT for VACUUM and ANALYZE
BUFFER_USAGE_LIMIT requires a parameter, and 'B' is a supported unit.

Author: Ryoga Yoshida
Reviewed-by: Shinya Kato
Discussion: https://postgr.es/m/9374034cb91b647b55a774a8980b0228@oss.nttdata.com
Backpatch-through: 16
2023-09-20 13:37:02 +09:00
Tom Lane ec693a3f30 Don't crash if cursor_to_xmlschema is used on a non-data-returning Portal.
cursor_to_xmlschema() assumed that any Portal must have a tupDesc,
which is not so.  Add a defensive check.

It's plausible that this mistake occurred because of the rather
poorly chosen name of the lookup function SPI_cursor_find(),
which in such cases is returning something that isn't very much
like a cursor.  Add some documentation to try to forestall future
errors of the same ilk.

Report and patch by Boyu Yang (docs changes by me).  Back-patch
to all supported branches.

Discussion: https://postgr.es/m/dd343010-c637-434c-a8cb-418f53bda3b8.yangboyu.yby@alibaba-inc.com
2023-09-18 14:27:47 -04:00
Tom Lane c372fbbd8e Doc: fix release date in release-16.sgml. 2023-09-11 16:25:06 -04:00
Bruce Momjian efaa50c783 doc: remove mention of backslash doubling in strings
Reported-by: Laurenz Albe

Discussion: https://postgr.es/m/0b03f91a875fb44182f5bed9e1d404ed6d138066.camel@cybertec.at

Author: Laurenz Albe

Backpatch-through: 11
2023-09-08 17:25:15 -04:00
Daniel Gustafsson bae47d7867 doc: Extend documentation of PG_TEST_EXTRA
Extend the PG_TEST_EXTRA documentation to mention resource intensive
tests as well. The previous wording only mentioned special software
and security in the main paragraph, with resource usage listed on one
of the tests in the list.

Backpatch to v15 where f47ed79cc8 added wal_consistenct_checking as
a PG_TEST_EXTRA target.

Author: Nazir Bilal Yavuz <byavuz81@gmail.com>
Discussion: https://postgr.es/m/CAN55FZ0OthTuBdiNkaX2BvxuHdK4Y1MVEb8_uEuD1yHMPmT9Og@mail.gmail.com
Backpatch-through: 15
2023-09-08 11:34:43 +02:00
Bruce Momjian 253bc4eb28 doc: mention that to_char() values are rounded
Reported-by: barsikdacat@gmail.com

Diagnosed-by: Laurenz Albe

Discussion: https://postgr.es/m/168991536429.626.9957835774751337210@wrigleys.postgresql.org

Author: Laurenz Albe

Backpatch-through: 11
2023-09-06 16:52:24 -04:00
Bruce Momjian 3ddc889e33 doc: PG 16 relnotes: fix subscriber role permission description
Reported-by: Magnus Hagander

Discussion: https://postgr.es/m/CABUevEwBXi5oqqMj429Lxjro1uu-fdKgSkJtgJS5aTOmujEGQQ@mail.gmail.com

Backpatch-through: 16 only
2023-09-06 15:36:07 -04:00
Peter Eisentraut ae7e3ae8c6 Update list of acknowledgments in release notes
current through 57a011b666
2023-09-06 08:11:22 +02:00
Bruce Momjian 57a011b666 doc: mention libpq regression tests
Reported-by: Ryo Matsumura

Discussion: https://postgr.es/m/TYCPR01MB11316B3FB56EE54D70BF0CEF6E8E4A@TYCPR01MB11316.jpnprd01.prod.outlook.com

Backpatch-through: 11
2023-09-05 13:05:28 -04:00
Bruce Momjian 22297cd65f doc: PG 16 relnotes: clarify LOCK TABLE description
Backpatch-through: 16 only
2023-08-31 15:14:18 -04:00
Peter Eisentraut 39d4207e87 Rename logical_replication_mode to debug_logical_replication_streaming
The logical_replication_mode GUC is intended for testing and debugging
purposes, but its current name may be misleading and encourage users to make
unnecessary changes.

To avoid confusion, renaming the GUC to a less misleading name
debug_logical_replication_streaming that casual users are less likely to mistakenly
assume needs to be modified in a regular logical replication setup.

Author: Hou Zhijie <houzj.fnst@cn.fujitsu.com>
Reviewed-by: Peter Smith <smithpb2250@gmail.com>
Discussion: https://www.postgresql.org/message-id/flat/d672d774-c44b-6fec-f993-793e744f169a%40eisentraut.org
2023-08-29 15:24:09 +02:00
Peter Eisentraut ef0e7dbcbe Update list of acknowledgments in release notes
current through a842ba407c
2023-08-27 20:30:53 +02:00
Peter Eisentraut 60d7d50f42 Remove incorrect name from release notes
This name was incorrect in the underlying commit message.  (The
correct name is already listed.)

Reported-by: Denis Laxalde <denis.laxalde@dalibo.com>
2023-08-27 20:29:05 +02:00
Peter Eisentraut 8d70eb731c Remove incorrect/duplicate name from list of acknowledgments
Reported-by: Vik Fearing <vik@postgresfriends.org>
2023-08-27 20:27:32 +02:00
Bruce Momjian a842ba407c doc: PG 16 relnotes: fix initdb encoding/locale item
Reported-by: Jeff Davis

Discussion:  https://postgr.es/m/c5369641862637c71a6c1c440ac7f122068ca4e7.camel@j-davis.com

Backpatch-through: 16 only
2023-08-24 21:44:31 -04:00
Bruce Momjian 7d8e703617 do: PG 16 relnotes: clarify last seq/index view names
Backpatch-through: 16 only
2023-08-23 21:33:03 -04:00
Daniel Gustafsson 5fd424c87a doc: Replace list of drivers and PLs with wiki link
The list of external language drivers and procedural languages was
never complete or exhaustive, and rather than attempting to manage
it the content has migrated to the wiki.  This replaces the tables
altogether with links to the wiki as we regularly get requests for
adding various projects,  which we reject without any clear policy
for why or how the content should be managed.

The threads linked to below are the most recent discussions about
this, the archives contain many more.

Backpatch to all supported branches since the list on the wiki
applies to all branches.

Author: Jonathan Katz <jkatz@postgresql.org>
Discussion: https://postgr.es/m/169165415312.635.10247434927885764880@wrigleys.postgresql.org
Discussion: https://postgr.es/m/169177958824.635.11087800083040275266@wrigleys.postgresql.org
Backpatch-through: v11
2023-08-23 14:13:07 +02:00
Peter Eisentraut 103df207a7 doc: Add more ICU rules examples
In particular, add an example EBCDIC collation.

Author: Daniel Verite <daniel@manitou-mail.org>
Discussion: https://www.postgresql.org/message-id/flat/35cc1684-e516-4a01-a256-351632d47066@manitou-mail.org
2023-08-23 11:24:43 +02:00
Peter Eisentraut 0b9127de12 doc: Improve ICU external link
It previously pointed to the collation API documentation, which our
users don't need, but the containing chapter seems useful.
2023-08-23 08:26:53 +02:00
Peter Eisentraut 6f168e077e Improve vertical spacing of documentation markup 2023-08-23 08:13:22 +02:00
Bruce Momjian d8cd49e992 doc: PG 16 relnotes: properly indent and word-wrap text
Backpatch-through: 16 only
2023-08-22 19:37:26 -04:00
Bruce Momjian e9f535463a doc: PG 16 relnotes: separate out psql \drg item
Reported-by: Pavel Luzanov

Discussion: https://postgr.es/m/29b97504-80a3-fdcc-538e-cadde3d8ecd5@postgrespro.ru

Backpatch-through: 16 only
2023-08-22 15:15:24 -04:00
Peter Eisentraut 8c76a55665 Add list of acknowledgments to release notes
This contains all individuals mentioned in the commit messages during
PostgreSQL 16 development.

current through REL_16_BETA3
2023-08-22 11:20:39 +02:00
Bruce Momjian 7fb906d80a doc: PG 16 relnotes: adjust RANGE/ROWS window item
Reported-by: Erwin Brandstetter

Discussion: https://postgr.es/m/CAGHENJ5Cj3wBH07YM5Lw2h5q8s65cNg_NEdkkWvmRo+vOormWw@mail.gmail.com

Backpatch-through: 16 only
2023-08-21 18:55:41 -04:00
Bruce Momjian 00be0bc3d5 doc: PG 16 relnotes: move role INHERIT item and clarify it
Also split out new role ADMIN syntax entry.

Reported-by: Pavel Luzanov

Discussion: https://postgr.es/m/0ebcc8ea-7f5a-d014-d53f-e078622be35d@aklaver.com

Backpatch-through: 16 only
2023-08-21 17:54:29 -04:00
Bruce Momjian 11f4935490 doc: PG 16 relnotes, add links to doc sections
Backpatch-through: 16 only
2023-08-16 22:22:12 -04:00
Bruce Momjian 6b86a3e0b4 doc: PG 16 relnotes, initial markup
Still need to add links to doc sections.

Backpatch-through: 16 only
2023-08-16 14:34:49 -04:00
Bruce Momjian c5c8bd29b9 doc: PG 16 relnotes, update "current as of" date
Backpatch-through: 16 only
2023-08-15 09:15:21 -04:00
Bruce Momjian 03fb43f6ed doc: PG 16 relnotes: udpate for commits since branching
Backpatch-through: 16 only
2023-08-14 17:28:39 -04:00
Bruce Momjian c8c033f721 doc: PG 16 relnotes, mark current as of 2023-08-09
Backpatch-through: 16 only
2023-08-09 22:09:17 -04:00
Bruce Momjian fc3e21282f doc: PG 16 relnotes, move createuser and SCM items
Reported-by: Noah Misch

Discussion: https://postgr.es/m/20230805230847.GA1370050@rfd.leadboat.com

Backpatch-through: 16 only
2023-08-09 20:48:31 -04:00
Bruce Momjian 0752461d3a doc: PG 16 relnotes, small wording improvement
Backpatch-through: 16 only
2023-08-09 20:37:41 -04:00
Bruce Momjian 6e1d1c5848 doc: PG 16 relnotes, merge and adjust CREATEROLE items
Reported-by: Noah Misch

Discussion: https://postgr.es/m/20230805230847.GA1370050@rfd.leadboat.com

Backpatch-through: 16 only
2023-08-09 18:01:50 -04:00
Bruce Momjian 89cadf30c6 doc: PG 16 relnotes, add Windows 10 huge pages fix
Reported-by: Michael Paquier

Discussion: https://postgr.es/m/ZL0M28/L+grYR8o7@paquier.xyz

Backpatch-through: 16 only
2023-08-09 17:47:03 -04:00
Bruce Momjian e90308ae6b doc: PG 16 relnotes, fix various typos
Reported-by: Erik Rijkers

Discussion: https://postgr.es/m/9c83328b-c0ff-070f-f2be-c3dce484e182@xs4all.nl

Backpatch-through: 16 only
2023-08-09 13:56:26 -04:00