1
0
mirror of https://github.com/postgres/postgres.git synced 2025-07-24 14:22:24 +03:00
Commit Graph

16678 Commits

Author SHA1 Message Date
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
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
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
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
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
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
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
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
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
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
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
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
c372fbbd8e Doc: fix release date in release-16.sgml. 2023-09-11 16:25:06 -04:00
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
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
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
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
ae7e3ae8c6 Update list of acknowledgments in release notes
current through 57a011b666
2023-09-06 08:11:22 +02:00
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
22297cd65f doc: PG 16 relnotes: clarify LOCK TABLE description
Backpatch-through: 16 only
2023-08-31 15:14:18 -04:00
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
ef0e7dbcbe Update list of acknowledgments in release notes
current through a842ba407c
2023-08-27 20:30:53 +02:00
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
8d70eb731c Remove incorrect/duplicate name from list of acknowledgments
Reported-by: Vik Fearing <vik@postgresfriends.org>
2023-08-27 20:27:32 +02:00
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
7d8e703617 do: PG 16 relnotes: clarify last seq/index view names
Backpatch-through: 16 only
2023-08-23 21:33:03 -04:00
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
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
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
6f168e077e Improve vertical spacing of documentation markup 2023-08-23 08:13:22 +02:00
d8cd49e992 doc: PG 16 relnotes: properly indent and word-wrap text
Backpatch-through: 16 only
2023-08-22 19:37:26 -04:00
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
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
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
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
11f4935490 doc: PG 16 relnotes, add links to doc sections
Backpatch-through: 16 only
2023-08-16 22:22:12 -04:00
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
c5c8bd29b9 doc: PG 16 relnotes, update "current as of" date
Backpatch-through: 16 only
2023-08-15 09:15:21 -04:00
03fb43f6ed doc: PG 16 relnotes: udpate for commits since branching
Backpatch-through: 16 only
2023-08-14 17:28:39 -04:00
c8c033f721 doc: PG 16 relnotes, mark current as of 2023-08-09
Backpatch-through: 16 only
2023-08-09 22:09:17 -04:00
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
0752461d3a doc: PG 16 relnotes, small wording improvement
Backpatch-through: 16 only
2023-08-09 20:37:41 -04:00
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
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
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
98cb73f5c9 doc: PG 16 relnotes, adjust \ef+ body comment to mention \sf
Reported-by: Laurenz Albe

Discussion: https://postgr.es/m/99d731a543501eb31bf7b8db43d231a037d7cc80.camel@cybertec.at

Backpatch-through: 16 only
2023-08-09 13:23:39 -04:00
86415153f4 doc: PG 16 relnotes, remove MAINTAIN item
Feature was removed by commit 957445996f.

Discussion: 957445996f

Backpatch-through: 16
2023-08-09 11:16:26 -04:00
f0a3805d7c Doc: update documentation for creating custom scan paths.
Commit f49842d1e added a new callback for custom scan paths, but missed
updating the documentation.

Back-patch to all supported branches.

Discussion: https://postgr.es/m/CAPmGK15ODkN%2B%3DhkBCufj1HBW0x5OTb65Xuy7ryXchMdiCMpx_g%40mail.gmail.com
2023-08-03 17:45:01 +09:00
0a1d2a7df8 Add psql \drg command to display role grants.
With the addition of INHERIT and SET options for role grants,
the historical display of role memberships in \du/\dg is woefully
inadequate.  Besides those options, there are pre-existing
shortcomings that you can't see the ADMIN option nor the grantor.

To fix this, remove the "Member of" column from \du/\dg altogether
(making that output usefully narrower), and invent a new meta-command
"\drg" that is specifically for displaying role memberships.  It
shows one row for each role granted to the selected role(s), with
the grant options and grantor.

We would not normally back-patch such a feature addition post
feature freeze, but in this case the change is mainly driven by
v16 changes in the server, so it seems appropriate to include it
in v16.

Pavel Luzanov, with bikeshedding and review from a lot of people,
but particularly David Johnston

Discussion: https://postgr.es/m/b9be2d0e-a9bc-0a30-492f-a4f68e4f7740@postgrespro.ru
2023-07-19 12:46:30 -04:00
245d0e6d0d Doc: improve description of IN and row-constructor comparisons.
IN and NOT IN work fine on records and arrays, so just say that
they accept "expressions" not "scalar expressions".  I think that
that phrasing was meant to say that they don't work on set-returning
expressions, but that's not the common meaning of "scalar".

Revise the description of row-constructor comparisons to make it
perhaps a bit less confusing.  (This partially reverts some
dubious wording changes made by commit f56651519.)

Per gripe from Ilya Nenashev.  Back-patch to supported branches.
In HEAD and v16, also drop a NOTE about pre-8.2 behavior, which
is hopefully no longer of interest to anybody.

Discussion: https://postgr.es/m/168968062460.632.14303906825812821399@wrigleys.postgresql.org
2023-07-19 11:00:34 -04:00