From: | Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> |
---|---|
To: | marek(dot)cvoren(at)gmail(dot)com, pgsql-docs(at)postgresql(dot)org |
Subject: | Re: Misleading |
Date: | 2017-04-05 04:28:46 |
Message-ID: | cd5ff30e-d97c-126b-4e22-939e5ae85d74@2ndquadrant.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On 3/28/17 07:02, marek(dot)cvoren(at)gmail(dot)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
From | Date | Subject | |
---|---|---|---|
Next Message | Peter Eisentraut | 2017-04-05 04:43:29 | Re: Consistent capitalization of procedural languages |
Previous Message | Peter Eisentraut | 2017-04-05 04:26:39 | Re: user mapping options list |