Re: Forgotten quote signs in description of "array value as a literal constant"

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: 40meta(at)gmail(dot)com, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Forgotten quote signs in description of "array value as a literal constant"
Date: 2020-10-06 16:37:33
Message-ID: CAKFQuwZnJu02KW=k=P+wsmjXzJtmnzzAE6V0sXPo9wWXmUOoKQ@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Mon, Oct 5, 2020 at 9:32 AM PG Doc comments form <noreply(at)postgresql(dot)org>
wrote:

> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/12/arrays.html
> Description:
>
> Documentation should mention single quotes in "array value as a literal
> constant" description.
>

The choice to not repeat the fact that string literals in PostgreSQL are
always written with surrounding single quotes (or dollar-quoting if one so
chooses) does not seem problematic, especially given the explicitness of
the examples. Much of the documentation rightfully assumes one has read
and memorized the syntax for writing a literal constant.

David J.

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2020-10-06 18:59:25 nondeterministic collations and statistics and pattern matching
Previous Message Magnus Hagander 2020-10-06 12:21:05 Re: Installation instructions vs binaries