From: Boboc Cristi <bobocc@yahoo.com>
To: David G. Johnston <david.g.johnston@gmail.com>
Cc: pgsql-docs@lists.postgresql.org <pgsql-docs@lists.postgresql.org>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>
Cc: Kirk Parker <khp@equatoria.us>
Subject: Re: Merge statement
Date: Thu, 17 Nov 2022 19:48:54 +0000 (UTC)
Message-ID: <601490217.1381469.1668714534805@mail.yahoo.com> (raw)
In-Reply-To: <CAKFQuwafZvR-6V0hOK9D_QLBiDE20C5uBCvoAyRW_PZhaR7Q0A@mail.gmail.com>
References: <166870559096.639.9180457099983661630@wrigleys.postgresql.org>
<20221117174737.w7jhwzarwmudolue@alvherre.pgsql>
<1970449059.1357827.1668709232468@mail.yahoo.com>
<CAKFQuwZcYAsccacKv=mG1F_rBzquKE2s9K4Djd0_zp8F6+NRwg@mail.gmail.com>
<375196813.1374739.1668711922900@mail.yahoo.com>
<CAKFQuwafZvR-6V0hOK9D_QLBiDE20C5uBCvoAyRW_PZhaR7Q0A@mail.gmail.com>
OK, I agree. I'll do my best to adopt the site conventions for every specific type of site within the corresponding pages.
Top-posting is not by my choice, it is how the email client works.
Since you have good reasons to keep the conventions of yours, then please accept that email clients have the same or very similar good reasons to keep their conventions too and stop criticize those.
Best regards, Cristi Boboc
On Thursday, November 17, 2022 at 09:21:21 PM GMT+2, David G. Johnston <david.g.johnston@gmail.com> wrote:
On Thu, Nov 17, 2022 at 12:06 PM Boboc Cristi <bobocc@yahoo.com> wrote:
I agree that your statement is true, but it is still not quite self sufficient.
For the time being I have no idea how to make it easier to be understood. As I have said, for me it is a little confusing.
I would pay attention to Kirk Parker <khp@equatoria.us> idea: when_clause [ when_clause [...]] to indicate repetitions without commas and xyz [, xyz[, ...]] to indicate repetitions that require commas.
Please don't top-post. The convention here is inline and bottom posting.
The convention for the documentation is to display repetition the way it is shown on this page. Having this page deviate from convention is undesirable, as is changing the convention. 100% satisfaction is not a goal - and as evidenced here the mailing lists are in place to handle rare cases of reader confusion.
David J.
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: bobocc@yahoo.com, david.g.johnston@gmail.com, pgsql-docs@lists.postgresql.org, alvherre@alvh.no-ip.org, khp@equatoria.us
Subject: Re: Merge statement
In-Reply-To: <601490217.1381469.1668714534805@mail.yahoo.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