Re: `pg_restore --if-exists` clarification

2023-09-29 Thread Gulyás Attila
Thank you so much! Appreciatively, Attila On Fri, Sep 29, 2023 at 1:15 PM Tom Lane wrote: > =?UTF-8?Q?Guly=C3=A1s_Attila?= writes: > > I would love to see Tom's version in the docs! It is only slightly longer > > than the current one, but absolutely clear of the purpose of both, and > the > >

Re: The documentation for storage type 'plain' actually allows single byte header

2023-09-29 Thread Tom Lane
Laurenz Albe writes: > On Fri, 2023-09-29 at 18:19 -0400, Bruce Momjian wrote: >> Where did we end with this? Is a doc patch the solution? > I don't think this went anywhere, and a doc patch is not the solution. > Tom has argued convincingly that single-byte headers are an effect of the > TOAST

Re: The documentation for storage type 'plain' actually allows single byte header

2023-09-29 Thread Laurenz Albe
On Fri, 2023-09-29 at 18:19 -0400, Bruce Momjian wrote: > On Thu, Jan 12, 2023 at 03:43:57PM +0100, Laurenz Albe wrote: > > On Tue, 2023-01-10 at 15:53 +, PG Doc comments form wrote: > > > https://www.postgresql.org/docs/devel/storage-toast.html - This is the > > > development version. > > > >

Re: Do we really want to mention 8.3 in current versions of the docs?

2023-09-29 Thread Bruce Momjian
On Thu, Jan 5, 2023 at 07:05:02PM +, Daniel Westermann (DWE) wrote: > Hi, > > do we really want to reference version 8.3 in current docs? > https://www.postgresql.org/docs/current/row-estimation-examples.html -> "The > outputs shown are taken from version 8.3" > > The examples seem to be mo

Re: The documentation for storage type 'plain' actually allows single byte header

2023-09-29 Thread Bruce Momjian
On Thu, Jan 12, 2023 at 03:43:57PM +0100, Laurenz Albe wrote: > On Tue, 2023-01-10 at 15:53 +, PG Doc comments form wrote: > > https://www.postgresql.org/docs/devel/storage-toast.html - This is the > > development version. > > > > > PLAIN prevents either compression or out-of-line storage; fur

Re: `pg_restore --if-exists` clarification

2023-09-29 Thread Tom Lane
=?UTF-8?Q?Guly=C3=A1s_Attila?= writes: > I would love to see Tom's version in the docs! It is only slightly longer > than the current one, but absolutely clear of the purpose of both, and the > behaviour when used in tandem. Hearing no objections, done at https://git.postgresql.org/gitweb/?p=pos

Re: `pg_restore --if-exists` clarification

2023-09-29 Thread Gulyás Attila
I would love to see Tom's version in the docs! It is only slightly longer than the current one, but absolutely clear of the purpose of both, and the behaviour when used in tandem. Appreciatively, Attila On Thu, Sep 28, 2023 at 1:03 PM Tom Lane wrote: > "David G. Johnston" writes: > >>> .. But