pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Bruce Momjian <bruce@momjian.us>
To: ap@robillo.net
Cc: pgsql-docs@postgresql.org
Subject: Re: [DOCS] Double negation in parameter description
Date: Wed, 22 Nov 2023 16:40:44 -0500
Message-ID: <ZV51XMu5dE20Pmrr@momjian.us> (raw)
In-Reply-To: <20170208152743.1411.6073@wrigleys.postgresql.org>
References: <20170208152743.1411.6073@wrigleys.postgresql.org>

On Wed, Feb  8, 2017 at 03:27:43PM +0000, ap@robillo.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@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.

Attachments:

  [text/x-diff] master.diff (646B, ../ZV51XMu5dE20Pmrr@momjian.us/2-master.diff)
  download | inline diff:
diff --git a/doc/src/sgml/ref/refresh_materialized_view.sgml b/doc/src/sgml/ref/refresh_materialized_view.sgml
index 675d6090f3..7a019162c3 100644
--- a/doc/src/sgml/ref/refresh_materialized_view.sgml
+++ b/doc/src/sgml/ref/refresh_materialized_view.sgml
@@ -67,7 +67,7 @@ REFRESH MATERIALIZED VIEW [ CONCURRENTLY ] <replaceable class="parameter">name</
       expression index or include a <literal>WHERE</literal> clause.
      </para>
      <para>
-      This option may not be used when the materialized view is not already
+      This option can only be used when the materialized view is already
       populated.
      </para>
      <para>

view thread (2+ messages)

Message-ID: <ZV51XMu5dE20Pmrr@momjian.us>
Permalink:  ../ZV51XMu5dE20Pmrr@momjian.us/
Also on:    postgresql.org/message-id/ZV51XMu5dE20Pmrr@momjian.us

 ·  · 

reply

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, ap@robillo.net
  Subject: Re: [DOCS] Double negation in parameter description
  In-Reply-To: <ZV51XMu5dE20Pmrr@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