Fix comment typo in /src/backend/command/cluster.c

Started by Masahiko Sawadaabout 12 years ago8 messageshackers
Jump to latest
#1Masahiko Sawada
sawada.mshk@gmail.com

Hi all,

Attached patch fixes the typo which is in "src/backend/command/cluster.c".

Regards,

-------
Sawada Masahiko

Attachments:

fix_typo-cluster.patchapplication/octet-stream; name=fix_typo-cluster.patchDownload+2-2
#2Andrew Dunstan
andrew@dunslane.net
In reply to: Masahiko Sawada (#1)
Re: Fix comment typo in /src/backend/command/cluster.c

On 01/27/2014 10:24 PM, Sawada Masahiko wrote:

Hi all,

Attached patch fixes the typo which is in "src/backend/command/cluster.c".

Are you sure that's a typo? "iff" is usually short hand for "if and only
if".

cheers

andrew

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

#3Gavin Flower
GavinFlower@archidevsys.co.nz
In reply to: Andrew Dunstan (#2)
Re: Fix comment typo in /src/backend/command/cluster.c

On 28/01/14 16:33, Andrew Dunstan wrote:

On 01/27/2014 10:24 PM, Sawada Masahiko wrote:

Hi all,

Attached patch fixes the typo which is in
"src/backend/command/cluster.c".

Are you sure that's a typo? "iff" is usually short hand for "if and
only if".

cheers

andrew

Certainly, that is how I would interpret it.

I came across that abbreviation in a first years Maths course
"Principles of Mathematics" in 1968 at the University of Auckland..

Cheers,
Gavin

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

#4Masahiko Sawada
sawada.mshk@gmail.com
In reply to: Andrew Dunstan (#2)
Re: Fix comment typo in /src/backend/command/cluster.c

On 01/27/2014 10:24 PM, Sawada Masahiko wrote:

Hi all,

Attached patch fixes the typo which is in "src/backend/command/cluster.
c".

Are you sure that's a typo? "iff" is usually short hand for "if and only
if".

Oops, I made mistake.
Thanks!

Regards,

-----
Masahiko Sawada

--
Regards,

-------
Sawada Masahiko

#5David Fetter
david@fetter.org
In reply to: Gavin Flower (#3)
Re: Fix comment typo in /src/backend/command/cluster.c

On Tue, Jan 28, 2014 at 04:48:35PM +1300, Gavin Flower wrote:

On 28/01/14 16:33, Andrew Dunstan wrote:

On 01/27/2014 10:24 PM, Sawada Masahiko wrote:

Hi all,

Attached patch fixes the typo which is in
"src/backend/command/cluster.c".

Are you sure that's a typo? "iff" is usually short hand for "if
and only if".

cheers

andrew

Certainly, that is how I would interpret it.

I came across that abbreviation in a first years Maths course
"Principles of Mathematics" in 1968 at the University of Auckland..

By my rough count (ack -l '\biff\b' |wc -l), it's used to mean
equivalence 81 times in the source tree. Should we have a glossary of
such terms?

Cheers,
David.
--
David Fetter <david@fetter.org> http://fetter.org/
Phone: +1 415 235 3778 AIM: dfetter666 Yahoo!: dfetter
Skype: davidfetter XMPP: david.fetter@gmail.com
iCal: webcal://www.tripit.com/feed/ical/people/david74/tripit.ics

Remember to vote!
Consider donating to Postgres: http://www.postgresql.org/about/donate

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

#6Michael Paquier
michael@paquier.xyz
In reply to: David Fetter (#5)
Re: Fix comment typo in /src/backend/command/cluster.c

On Tue, Jan 28, 2014 at 2:29 PM, David Fetter <david@fetter.org> wrote:

On Tue, Jan 28, 2014 at 04:48:35PM +1300, Gavin Flower wrote:

On 28/01/14 16:33, Andrew Dunstan wrote:

On 01/27/2014 10:24 PM, Sawada Masahiko wrote:

Hi all,

Attached patch fixes the typo which is in
"src/backend/command/cluster.c".

Are you sure that's a typo? "iff" is usually short hand for "if
and only if".

cheers

andrew

Certainly, that is how I would interpret it.

I came across that abbreviation in a first years Maths course
"Principles of Mathematics" in 1968 at the University of Auckland..

By my rough count (ack -l '\biff\b' |wc -l), it's used to mean
equivalence 81 times in the source tree. Should we have a glossary of
such terms?

And what about directly replacing those expressions in the comments of
the code with some more understandable language? This would be more
suited for non-native English speakers than maintaining a glossary
that you can surely find here and there after some googling.
--
Michael

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

#7David Fetter
david@fetter.org
In reply to: Michael Paquier (#6)
Re: Fix comment typo in /src/backend/command/cluster.c

On Tue, Jan 28, 2014 at 02:51:22PM +0900, Michael Paquier wrote:

On Tue, Jan 28, 2014 at 2:29 PM, David Fetter <david@fetter.org> wrote:

On Tue, Jan 28, 2014 at 04:48:35PM +1300, Gavin Flower wrote:

On 28/01/14 16:33, Andrew Dunstan wrote:

On 01/27/2014 10:24 PM, Sawada Masahiko wrote:

Hi all,

Attached patch fixes the typo which is in
"src/backend/command/cluster.c".

Are you sure that's a typo? "iff" is usually short hand for "if
and only if".

cheers

andrew

Certainly, that is how I would interpret it.

I came across that abbreviation in a first years Maths course
"Principles of Mathematics" in 1968 at the University of Auckland..

By my rough count (ack -l '\biff\b' |wc -l), it's used to mean
equivalence 81 times in the source tree. Should we have a glossary of
such terms?

And what about directly replacing those expressions in the comments of
the code with some more understandable language? This would be more
suited for non-native English speakers than maintaining a glossary
that you can surely find here and there after some googling.

I'm interested to find 29 instances of "if and only if" in the source,
which should be the same thing.

Please find attached a mechanically done patch which expands the
remaining instances of "iff" to the longer form, all of which are in
comments. The patched source passes make -j8, but I have not tested
it further.

Cheers,
David.
--
David Fetter <david@fetter.org> http://fetter.org/
Phone: +1 415 235 3778 AIM: dfetter666 Yahoo!: dfetter
Skype: davidfetter XMPP: david.fetter@gmail.com
iCal: webcal://www.tripit.com/feed/ical/people/david74/tripit.ics

Remember to vote!
Consider donating to Postgres: http://www.postgresql.org/about/donate

Attachments:

de_iff_01.patchtext/plain; charset=us-asciiDownload+168-164
#8Heikki Linnakangas
heikki.linnakangas@enterprisedb.com
In reply to: David Fetter (#7)
Re: Fix comment typo in /src/backend/command/cluster.c

On 01/28/2014 08:58 AM, David Fetter wrote:

On Tue, Jan 28, 2014 at 02:51:22PM +0900, Michael Paquier wrote:

On Tue, Jan 28, 2014 at 2:29 PM, David Fetter <david@fetter.org> wrote:

On Tue, Jan 28, 2014 at 04:48:35PM +1300, Gavin Flower wrote:

I came across that abbreviation in a first years Maths course
"Principles of Mathematics" in 1968 at the University of Auckland..

By my rough count (ack -l '\biff\b' |wc -l), it's used to mean
equivalence 81 times in the source tree. Should we have a glossary of
such terms?

And what about directly replacing those expressions in the comments of
the code with some more understandable language? This would be more
suited for non-native English speakers than maintaining a glossary
that you can surely find here and there after some googling.

I'm interested to find 29 instances of "if and only if" in the source,
which should be the same thing.

Please find attached a mechanically done patch which expands the
remaining instances of "iff" to the longer form, all of which are in
comments. The patched source passes make -j8, but I have not tested
it further.

"iff" is well-known abbreviation, I don't see a need to expunge it from
the source code. There might be places where some other wording or
spelling it out as "if and only if" would be better, but a mechanical
search/replace is not warranted.

FWIW, many other languages use a similar abbreviation for the same
thing, so it's not impossible for a non-native English speaker with
basic math education to guess. In Finnish, it's "joss", which stands for
"jos ja vain jos", and a quick look at Wikipedia shows a similar
construct in many other languages.

- Heikki

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