pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedFix contributor name-related inconsistencies in release-12.sgml
9+ messages / 7 participants
[nested] [flat]
Commits from this thread:
2019-09-23 ac8fb2c7e2 Doc: clean up some issues with spellings of contributor names.
* Fix contributor name-related inconsistencies in release-12.sgml
@ 2019-09-23 11:08 Alexander Lakhin <exclusion@gmail.com>
0 siblings, 2 replies; 9+ messages in thread
From: Alexander Lakhin @ 2019-09-23 11:08 UTC (permalink / raw)
To: pgsql-docs
Hello,
While translating Release Notes for version 12 I found some
inconsistencies with contributor names.
1. Constantine Kuznetsov and Konstantin Kuznetsov are the same person.
2. Sho Kato and Kato Sho too.
3. Takayuki Tsunakawa is present in the Acknowledgments, but Tsunakawa
Takayuki is referred in the change list.
Regarding Japanese names I found that in the Postgres documentation the
given name is mostly specified first. E.g.: Daisuke Higuchi, Haruka
Takatsuka, Hayato Kuroda, Hironobu Suzuki, Keiichi Hirobe, Kenji Uno,...
So I would remove "Kato Sho" because "Sho" is a given name:
https://en.wikipedia.org/wiki/Sh%C5%8D_(given_name)
And change "Tsunakawa Takayuki" to "Takayuki Tsunakawa" because
"Takayuki" is a given name: https://en.wikipedia.org/wiki/Takayuki
Also, there are other names spelled in the reverse order:
Fujii Masao
Koizumi Satoru
Matsumura Ryo
So I propose a second patch to fix these names too.
Best regards,
Alexander
Attachments: download all (2 files, .tar.gz)
release-12-names-fix.patch (text/x-patch, 1.5K) download
diff --git a/doc/src/sgml/release-12.sgml b/doc/src/sgml/release-12.sgml
index 129787b4c9..dddc7c985c 100644
--- a/doc/src/sgml/release-12.sgml
+++ b/doc/src/sgml/release-12.sgml
@@ -1939,7 +1939,7 @@ Author: Michael Paquier <michael@paquier.xyz>
<para>
Allow the streaming replication timeout (<xref
linkend="guc-wal-sender-timeout"/>) to be set per connection
- (Tsunakawa Takayuki)
+ (Takayuki Tsunakawa)
</para>
<para>
@@ -2140,7 +2140,7 @@ Author: Fujii Masao <fujii@postgresql.org>
<para>
Add <xref linkend="sql-vacuum"/> and <command>CREATE
TABLE</command> options to prevent <command>VACUUM</command>
- from truncating trailing empty pages (Tsunakawa Takayuki)
+ from truncating trailing empty pages (Takayuki Tsunakawa)
</para>
<para>
@@ -3575,7 +3575,6 @@ Author: Michael Paquier <michael@paquier.xyz>
<member>Christoph Moench-Tegeder</member>
<member>Clemens Ladisch</member>
<member>Colm McHugh</member>
- <member>Constantine Kuznetsov</member>
<member>Corey Huinker</member>
<member>Craig Ringer</member>
<member>Dagfinn Ilmari Mannsåker</member>
@@ -3851,7 +3850,6 @@ Author: Michael Paquier <michael@paquier.xyz>
<member>Sergio Conde Gómez</member>
<member>Shawn Debnath</member>
<member>Shay Rojansky</member>
- <member>Sho Kato</member>
<member>Shohei Mochizuki</member>
<member>Shouyu Luo</member>
<member>Simon Riggs</member>
release-12-names-fix2.patch (text/x-patch, 2.8K) download
diff --git a/doc/src/sgml/release-12.sgml b/doc/src/sgml/release-12.sgml
index dddc7c985c..e57154b387 100644
--- a/doc/src/sgml/release-12.sgml
+++ b/doc/src/sgml/release-12.sgml
@@ -254,7 +254,7 @@ Author: Peter Eisentraut <peter_e@gmx.net>
<para>
Move <filename>recovery.conf</filename> settings into <link
linkend="runtime-config-wal-archive-recovery"><filename>postgresql.conf</filename></link>
- (Fujii Masao, Simon Riggs, Abhijit Menon-Sen, Sergei Kornilov)
+ (Masao Fujii, Simon Riggs, Abhijit Menon-Sen, Sergei Kornilov)
</para>
<para>
@@ -2675,7 +2675,7 @@ Author: Michael Meskes <meskes@postgresql.org>
<para>
Allow <xref linkend="app-ecpg"/> to create variables of data type
- <type>bytea</type> (Matsumura Ryo)
+ <type>bytea</type> (Ryo Matsumura)
</para>
<para>
@@ -2692,7 +2692,7 @@ Author: Michael Meskes <meskes@postgresql.org>
<para>
Add <command>PREPARE AS</command> support to
- <productname>ECPG</productname> (Matsumura Ryo)
+ <productname>ECPG</productname> (Ryo Matsumura)
</para>
</listitem>
@@ -3621,7 +3621,6 @@ Author: Michael Paquier <michael@paquier.xyz>
<member>Fabrízio de Royes Mello</member>
<member>Feike Steenbergen</member>
<member>Filip Rembialkowski</member>
- <member>Fujii Masao</member>
<member>Gaby Schilders</member>
<member>Geert Lobbestael</member>
<member>George Tarasov</member>
@@ -3711,7 +3710,6 @@ Author: Michael Paquier <michael@paquier.xyz>
<member>Kevin Hale Boyes</member>
<member>Kieran McCusker</member>
<member>Kirk Jamison</member>
- <member>Koizumi Satoru</member>
<member>Konstantin Knizhnik</member>
<member>Konstantin Kuznetsov</member>
<member>Kristjan Tammekivi</member>
@@ -3748,9 +3746,9 @@ Author: Michael Paquier <michael@paquier.xyz>
<member>Markus Winand</member>
<member>Martín Marqués</member>
<member>Masahiko Sawada</member>
+ <member>Masao Fujii</member>
<member>Mateusz Guzik</member>
<member>Mathias Brossard</member>
- <member>Matsumura Ryo</member>
<member>Matt Williams</member>
<member>Matthias Otterbach</member>
<member>Matvey Arye</member>
@@ -3838,11 +3836,13 @@ Author: Michael Paquier <michael@paquier.xyz>
<member>Rui Hai Jiang</member>
<member>Rushabh Lathia</member>
<member>Ryan Lambert</member>
+ <member>Ryo Matsumura</member>
<member>Ryohei Nagaura</member>
<member>Ryohei Takahashi</member>
<member>Samuel Williams</member>
<member>Sand Stone</member>
<member>Sanyo Capobiango</member>
+ <member>Satoru Koizumi</member>
<member>Sean Johnston</member>
<member>Serge Latyntsev</member>
<member>Sergei Kornilov</member>
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fix contributor name-related inconsistencies in release-12.sgml
@ 2019-09-23 14:32 Tom Lane <tgl@sss.pgh.pa.us>
parent: Alexander Lakhin <exclusion@gmail.com>
1 sibling, 0 replies; 9+ messages in thread
From: Tom Lane @ 2019-09-23 14:32 UTC (permalink / raw)
To: Alexander Lakhin <exclusion@gmail.com>; +Cc: pgsql-docs
Alexander Lakhin <exclusion@gmail.com> writes:
> While translating Release Notes for version 12 I found some
> inconsistencies with contributor names.
Proposed changes seem reasonable from here. Pushed, thanks!
regards, tom lane
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fix contributor name-related inconsistencies in release-12.sgml
@ 2019-09-24 22:02 Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
parent: Alexander Lakhin <exclusion@gmail.com>
1 sibling, 1 reply; 9+ messages in thread
From: Peter Eisentraut @ 2019-09-24 22:02 UTC (permalink / raw)
To: Alexander Lakhin <exclusion@gmail.com>; pgsql-docs
On 2019-09-23 13:08, Alexander Lakhin wrote:
> While translating Release Notes for version 12 I found some
> inconsistencies with contributor names.
> 1. Constantine Kuznetsov and Konstantin Kuznetsov are the same person.
> 2. Sho Kato and Kato Sho too.
> 3. Takayuki Tsunakawa is present in the Acknowledgments, but Tsunakawa
> Takayuki is referred in the change list.
> Regarding Japanese names I found that in the Postgres documentation the
> given name is mostly specified first. E.g.: Daisuke Higuchi, Haruka
> Takatsuka, Hayato Kuroda, Hironobu Suzuki, Keiichi Hirobe, Kenji Uno,...
> So I would remove "Kato Sho" because "Sho" is a given name:
> https://en.wikipedia.org/wiki/Sh%C5%8D_(given_name)
> And change "Tsunakawa Takayuki" to "Takayuki Tsunakawa" because
> "Takayuki" is a given name: https://en.wikipedia.org/wiki/Takayuki
>
> Also, there are other names spelled in the reverse order:
> Fujii Masao
> Koizumi Satoru
> Matsumura Ryo
> So I propose a second patch to fix these names too.
We had discussed this in previous years and resolved that we use the
forms that these individuals use when posting to these mailing lists, in
whichever order they prefer. So as far as I'm concerned, the forms
listed in the release notes for PG10 and PG11 are canonical and should
continue to be used.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fix contributor name-related inconsistencies in release-12.sgml
@ 2019-09-24 22:52 Tom Lane <tgl@sss.pgh.pa.us>
parent: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
0 siblings, 2 replies; 9+ messages in thread
From: Tom Lane @ 2019-09-24 22:52 UTC (permalink / raw)
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>; +Cc: Alexander Lakhin <exclusion@gmail.com>; pgsql-docs
Peter Eisentraut <peter.eisentraut@2ndquadrant.com> writes:
> On 2019-09-23 13:08, Alexander Lakhin wrote:
>> While translating Release Notes for version 12 I found some
>> inconsistencies with contributor names.
> We had discussed this in previous years and resolved that we use the
> forms that these individuals use when posting to these mailing lists, in
> whichever order they prefer. So as far as I'm concerned, the forms
> listed in the release notes for PG10 and PG11 are canonical and should
> continue to be used.
I have no strong feelings either way, so feel free to undo whatever
you think should be undone.
I have noted that many of our Japanese contributors show a different name
order in their From: line than in their signature/footer, so it's not
entirely clear which preference they're expressing.
regards, tom lane
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fix contributor name-related inconsistencies in release-12.sgml
@ 2019-09-25 05:10 Michael Paquier <michael@paquier.xyz>
parent: Tom Lane <tgl@sss.pgh.pa.us>
1 sibling, 1 reply; 9+ messages in thread
From: Michael Paquier @ 2019-09-25 05:10 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>; Alexander Lakhin <exclusion@gmail.com>; pgsql-docs
On Tue, Sep 24, 2019 at 06:52:18PM -0400, Tom Lane wrote:
> I have no strong feelings either way, so feel free to undo whatever
> you think should be undone.
>
> I have noted that many of our Japanese contributors show a different name
> order in their From: line than in their signature/footer, so it's not
> entirely clear which preference they're expressing.
The formal and official way is to have the family name first, and then
the first name, but I agree with the approach we have to not be too
formal and just list individuals based on how they present themselves
in their emails.
Note: there is no actual concept of middle name in Japan, which brings
its own set of annoying explanations when it comes to do any kind of
applications...
--
Michael
Attachments:
signature.asc (application/pgp-signature, 832B) download
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fix contributor name-related inconsistencies in release-12.sgml
@ 2019-09-25 05:53 Alexander Law <exclusion@gmail.com>
parent: Michael Paquier <michael@paquier.xyz>
0 siblings, 0 replies; 9+ messages in thread
From: Alexander Law @ 2019-09-25 05:53 UTC (permalink / raw)
To: Michael Paquier <michael@paquier.xyz>; +Cc: Tom Lane <tgl@sss.pgh.pa.us>; Peter Eisentraut <peter.eisentraut@2ndquadrant.com>; pgsql-docs
Hello,
ср, 25 сент. 2019 г., 8:10 Michael Paquier <michael@paquier.xyz>:
> On Tue, Sep 24, 2019 at 06:52:18PM -0400, Tom Lane wrote:
> > I have no strong feelings either way, so feel free to undo whatever
> > you think should be undone.
> >
> > I have noted that many of our Japanese contributors show a different name
> > order in their From: line than in their signature/footer, so it's not
> > entirely clear which preference they're expressing.
>
> The formal and official way is to have the family name first, and then
> the first name, but I agree with the approach we have to not be too
> formal and just list individuals based on how they present themselves
> in their emails.
>
In fact, here in Russia the "Family-name Given-name [Patronymic-name]"
order is formal and official too. And in Russian e-mail's (mostly internal,
not for export) you can also encounter such a spelling. But I think it's
not the matter of the person's preference, but rather the matter of
"officiality", and probably, conventions accepted (maybe at the person'
organization).
So if someone will change it's job or status, and will want to use more
official order, I would find it rather strange to see Lasty Firsty amongst
all the other Russian contributors having the given-name-first order.
Best regards,
Alexander
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fix contributor name-related inconsistencies in release-12.sgml
@ 2019-09-25 06:13 Magnus Hagander <magnus@hagander.net>
parent: Tom Lane <tgl@sss.pgh.pa.us>
1 sibling, 1 reply; 9+ messages in thread
From: Magnus Hagander @ 2019-09-25 06:13 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>; Alexander Law <exclusion@gmail.com>; pgsql-docs
On Wed, Sep 25, 2019, 00:52 Tom Lane <tgl@sss.pgh.pa.us> wrote:
> Peter Eisentraut <peter.eisentraut@2ndquadrant.com> writes:
> > On 2019-09-23 13:08, Alexander Lakhin wrote:
> >> While translating Release Notes for version 12 I found some
> >> inconsistencies with contributor names.
>
> > We had discussed this in previous years and resolved that we use the
> > forms that these individuals use when posting to these mailing lists, in
> > whichever order they prefer. So as far as I'm concerned, the forms
> > listed in the release notes for PG10 and PG11 are canonical and should
> > continue to be used.
>
> I have no strong feelings either way, so feel free to undo whatever
> you think should be undone.
>
> I have noted that many of our Japanese contributors show a different name
> order in their From: line than in their signature/footer, so it's not
> entirely clear which preference they're expressing.
>
I would say use the one in the signature in those cases. My guess would be
that that part is under control of the individual, but the from field is in
control of the HR department or whomever controls the name order in the
catalogs of their big company.
It's fairly common here, for example, to have "lastname, first" in the
from, but nobody would use that in a scenario like this. The reason
typically being wanting "phone book sorting" in the company wide address
book, which does sort on lastname. As an employee people can typically
control the name order in their signature, but not the address book.
The situation in Asia may of course be very different, as it often is, but
I think the general rule of who controls the order where still applies.
/Magnus
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fix contributor name-related inconsistencies in release-12.sgml
@ 2019-09-28 20:31 Bruce Momjian <bruce@momjian.us>
parent: Magnus Hagander <magnus@hagander.net>
0 siblings, 1 reply; 9+ messages in thread
From: Bruce Momjian @ 2019-09-28 20:31 UTC (permalink / raw)
To: Magnus Hagander <magnus@hagander.net>; +Cc: Tom Lane <tgl@sss.pgh.pa.us>; Peter Eisentraut <peter.eisentraut@2ndquadrant.com>; Alexander Law <exclusion@gmail.com>; pgsql-docs
On Wed, Sep 25, 2019 at 08:13:16AM +0200, Magnus Hagander wrote:
> I would say use the one in the signature in those cases. My guess would be that
> that part is under control of the individual, but the from field is in control
> of the HR department or whomever controls the name order in the catalogs of
> their big company.
>
> It's fairly common here, for example, to have "lastname, first" in the from,
> but nobody would use that in a scenario like this. The reason typically being
> wanting "phone book sorting" in the company wide address book, which does sort
> on lastname. As an employee people can typically control the name order in
> their signature, but not the address book.
>
> The situation in Asia may of course be very different, as it often is, but I
> think the general rule of who controls the order where still applies.
Uh, we are going to need for committers to handle this issue since it is
unlikely we can research email signatures when writing the release
notes.
--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com
+ As you are, so once was I. As I am, so you will be. +
+ Ancient Roman grave inscription +
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fix contributor name-related inconsistencies in release-12.sgml
@ 2019-09-28 20:39 Tom Lane <tgl@sss.pgh.pa.us>
parent: Bruce Momjian <bruce@momjian.us>
0 siblings, 0 replies; 9+ messages in thread
From: Tom Lane @ 2019-09-28 20:39 UTC (permalink / raw)
To: Bruce Momjian <bruce@momjian.us>; +Cc: Magnus Hagander <magnus@hagander.net>; Peter Eisentraut <peter.eisentraut@2ndquadrant.com>; Alexander Law <exclusion@gmail.com>; pgsql-docs
Bruce Momjian <bruce@momjian.us> writes:
> Uh, we are going to need for committers to handle this issue since it is
> unlikely we can research email signatures when writing the release
> notes.
Committers are not going to handle it with any consistency either.
In the end it's going to be the job of whoever is making the
list-of-contributors at the end of a release cycle. So far that's
been Peter.
regards, tom lane
^ permalink raw reply [nested|flat] 9+ messages in thread
end of thread, other threads:[~2019-09-28 20:39 UTC | newest]
Thread overview: 9+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2019-09-23 11:08 Fix contributor name-related inconsistencies in release-12.sgml Alexander Lakhin <exclusion@gmail.com>
2019-09-23 14:32 ` Tom Lane <tgl@sss.pgh.pa.us>
2019-09-24 22:02 ` Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
2019-09-24 22:52 ` Tom Lane <tgl@sss.pgh.pa.us>
2019-09-25 05:10 ` Michael Paquier <michael@paquier.xyz>
2019-09-25 05:53 ` Alexander Law <exclusion@gmail.com>
2019-09-25 06:13 ` Magnus Hagander <magnus@hagander.net>
2019-09-28 20:31 ` Bruce Momjian <bruce@momjian.us>
2019-09-28 20:39 ` Tom Lane <tgl@sss.pgh.pa.us>
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