pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: marek.cvoren@gmail.com
To: pgsql-docs@postgresql.org
Subject: Misleading
Date: Tue, 28 Mar 2017 11:02:53 +0000
Message-ID: <20170328110253.2695.62609@wrigleys.postgresql.org> (raw)
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/9.6/static/pgupgrade.html
Description:

Hello,

Please correct following part of pg_upgrade documentation:
`You can also specify user and port values, and whether you want the data
linked instead of copied (the default).`

It is not clear what is the default option. If you read the whole sentence,
then context might be misinterpreted to `data linked instead of copied` is
default but you meant that copying is default. Please correct this as it is
confusing and can lead someone to big troubles.

My suggestion:
 - completely omit confusing default word:
`You can also specify user and port values, and whether you want the data
linked instead of copied.`

Thank you.

Cheers,
Marek

-- 
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


view thread (3+ messages)  latest in thread

Message-ID: <20170328110253.2695.62609@wrigleys.postgresql.org>
Permalink:  ../20170328110253.2695.62609@wrigleys.postgresql.org/
Also on:    postgresql.org/message-id/20170328110253.2695.62609@wrigleys.postgresql.org

 · 

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: marek.cvoren@gmail.com
  Subject: Re: Misleading
  In-Reply-To: <20170328110253.2695.62609@wrigleys.postgresql.org>

* 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