Re: docs: psql and variable interpolation - Mailing list pgsql-docs

From David G. Johnston
Subject Re: docs: psql and variable interpolation
Date
Msg-id CAKFQuwb5gS3qrAuF4FzEid4EwDrMVKwBP2bHD_o=S5nOiEsfXQ@mail.gmail.com
Whole thread Raw
In response to docs: psql and variable interpolation  (Philippe Beaudoin <philippe.beaudoin@dalibo.com>)
Responses Re: docs: psql and variable interpolation
List pgsql-docs
On Monday, July 13, 2020, Philippe Beaudoin <philippe.beaudoin@dalibo.com> wrote:

The first sentence of this SQL interpolation chapter says "A key feature of psql variables is that you can substitute (interpolate) them into regular SQL statements, as well as the arguments of meta-commands." But nothing in this chapter indicates that there are exceptions.

May be we could have a wording adjustment with something like : "A key feature of psql variables is that you can substitute (interpolate) them into regular SQL statements, as well as the arguments of meta-commands (unless specifically noted)."


Having “unless otherwise noted” be implied doesn’t seem like a big failing.  As for this case it is documented as being an exception:

“Unlike most other meta-commands, the entire remainder of the line is always taken to be the arguments of \copy, and neither variable interpolation nor backquote expansion are performed in the arguments.”

If it is only \copy that is an exception I’d rather just say (except \copy} and not have the user meticulously read each item for the single exception.  This extends to if there are a few.

David J.

pgsql-docs by date:

Previous
From: Pavel Stehule
Date:
Subject: Re: docs: psql and variable interpolation
Next
From: J Lumby
Date:
Subject: TIMESTAMP