From: Bruce Momjian <bruce@momjian.us>
To: fotis.koutoupas@gmail.com
To: pgsql-docs@lists.postgresql.org
Subject: Re: Potential typo in abbreviated insertion query
Date: Sat, 9 Jan 2021 12:11:35 -0500
Message-ID: <20210109171135.GA19555@momjian.us> (raw)
In-Reply-To: <20201231184456.GG22199@momjian.us>
References: <160912275508.676.17469511338925622905@wrigleys.postgresql.org>
<20201231184456.GG22199@momjian.us>
On Thu, Dec 31, 2020 at 01:44:56PM -0500, Bruce Momjian wrote:
> On Mon, Dec 28, 2020 at 02:32:35AM +0000, PG Doc comments form wrote:
> > The following documentation comment has been logged on the website:
> >
> > Page: https://www.postgresql.org/docs/13/executor.html
> > Description:
> >
> > It's located within the parentheses of the last paragraph.
> >
> > >(A simple INSERT ... VALUES command creates a trivial plan tree consisting
> > of a single Result node, which computes just one result row, and ModifyTable
> > above it to perform the insertion. But INSERT ... SELECT can demand the full
> > power of the executor mechanism.)
> >
> > I'm under the impression that the second inline code block refers to `INSERT
> > ... VALUES`.
>
> I think the text is correct, but I also think it is trying to do too
> much in one paragraph. Here is a doc patch to improve this.
Patch applied to all supported branches.
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EnterpriseDB https://enterprisedb.com
The usefulness of a cup is in its emptiness, Bruce Lee
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: bruce@momjian.us, fotis.koutoupas@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Potential typo in abbreviated insertion query
In-Reply-To: <20210109171135.GA19555@momjian.us>
* 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