Double negation in parameter description

Lists: pgsql-docs
From: ap(at)robillo(dot)net
To: pgsql-docs(at)postgresql(dot)org
Subject: Double negation in parameter description
Date: 2017-02-08 15:27:43
Message-ID: [email protected]
Views: Whole Thread | Raw Message | Download mbox | Resend email
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/9.6/static/sql-refreshmaterializedview.html
Description:

In the description of the CONCURRENTLY parameter (3rd line/paragraph, the
statement employs double negation which makes it hard to read and
understand.

"This option may not be used when the materialized view is not already
populated."

I guess the author would want to mean:

"This option may only be used on a populated materialized view."?

Your clarification is much appreciated.


From: Bruce Momjian <bruce(at)momjian(dot)us>
To: ap(at)robillo(dot)net
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: [DOCS] Double negation in parameter description
Date: 2023-11-22 21:40:44
Message-ID: [email protected]
Views: Whole Thread | Raw Message | Download mbox | Resend email
Lists: pgsql-docs

On Wed, Feb 8, 2017 at 03:27:43PM +0000, ap(at)robillo(dot)net wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/9.6/static/sql-refreshmaterializedview.html
> Description:
>
> In the description of the CONCURRENTLY parameter (3rd line/paragraph, the
> statement employs double negation which makes it hard to read and
> understand.
>
> &quot;This option may not be used when the materialized view is not already
> populated.&quot;
>
> I guess the author would want to mean:
>
> &quot;This option may only be used on a populated materialized view.&quot;?
>
> Your clarification is much appreciated.

I know this is six years old, but fixed in master with the attached
patch.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

Only you can decide what is important to you.

Attachment Content-Type Size
master.diff text/x-diff 647 bytes