From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
To: marek.cvoren@gmail.com
To: pgsql-docs@postgresql.org
Subject: Re: Misleading
Date: Wed, 5 Apr 2017 00:28:46 -0400
Message-ID: <cd5ff30e-d97c-126b-4e22-939e5ae85d74@2ndquadrant.com> (raw)
In-Reply-To: <20170328110253.2695.62609@wrigleys.postgresql.org>
References: <20170328110253.2695.62609@wrigleys.postgresql.org>
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
On 3/28/17 07:02, marek.cvoren@gmail.com wrote:
> 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.`
It's debatable whether that sentence is unclear, I think, but the change
you propose actually loses the information about what mode is the
default, which wouldn't be good.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
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: peter.eisentraut@2ndquadrant.com, marek.cvoren@gmail.com
Subject: Re: Misleading
In-Reply-To: <cd5ff30e-d97c-126b-4e22-939e5ae85d74@2ndquadrant.com>
* 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