[issue31937] Add the term "dunder" to the glossary

[Brett Cannon]

Change by Brett Cannon :


--
resolution:  -> rejected
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Stéphane Wirtel]

Stéphane Wirtel  added the comment:

David, 

I have no objection to closing this issue and I totally agree with your comment.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[R. David Murray]

R. David Murray  added the comment:

EAFP and BDFL are not python folk terminology (the former never was, the latter 
may have originated with us but it has widespread use).  They are also 
acronyms.  'dunder' is the phonetic spelling of a way of pronouncing 
punctuation.  Raymond's examples of 'stir' and 'repper' are similar: phonetic 
spellings of ways of pronouncing something that isn't a word.

It seems to me that such phonetic spellings do no belong in the glossary.  The 
counter argument is that unlike the other two 'dunder' does appear 
*occasionally* in text...but the only place it appears in our documentation 
(that I can find via grep) is in the enum docs, and there it should be replaced 
by the correct term "special methods", especially since it there it is spelled 
"__dunder__".

For 'stir' and 'repper' the text spelling is __str__/str and __repr__/repr, for 
'dunder XXX' the correct text spelling is the special method name, and for the 
"dunder method" the correct spelling (and I would argue the correct 
pronunciation :) is "special method".  That is, 'dunder' is mostly used in 
speech, not text.  It is not a "word" in the sense that the rest of the 
glossary entries are.
  
So, I vote with Raymond and others that this term does *not* belong in our 
glossary.

I recommend closing this issue as rejected.

--
nosy: +r.david.murray

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Stéphane Wirtel]

Stéphane Wirtel  added the comment:

Just added the term in the glossary

If you want to review this PR, thank you

--
nosy: +matrixise

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Stéphane Wirtel]

Change by Stéphane Wirtel :


--
keywords: +patch
pull_requests: +5399
stage: needs patch -> patch review

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Serhiy Storchaka]

Serhiy Storchaka  added the comment:

The term "dunder" is used in PEPs: PEP 8, PEP 408, PEP 435, PEP 505, PEP 520, 
PEP 526, and in the enum module documentation.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Raymond Hettinger]

Raymond Hettinger  added the comment:

Recommend closing this and leaving it for StackOverflow.  I really don't want 
to further garbage-up the glossary.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Raymond Hettinger]

Change by Raymond Hettinger :


--
assignee: docs@python -> fdrake
nosy: +fdrake

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Serhiy Storchaka]

Serhiy Storchaka  added the comment:

I never seen terms like "stir" or "inker", but the term "dunder" is used pretty 
widely. The glossary already contains abbreviations and Python folk terminology 
like EAFP and BDFL.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Antoine Pitrou]

Antoine Pitrou  added the comment:

Agreed with Raymond that Python folk terminology should not go into the 
glossary.  I don't think I ever say "dunder" myself.

--
nosy: +pitrou

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Mariatta Wijaya]

Mariatta Wijaya  added the comment:

Thanks Raymond. +1 for adding the above list. 

I don't think FAQ is the right place either, I prefer we don't have to add the 
entries in the form of questions & answers.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Raymond Hettinger]

Raymond Hettinger  added the comment:

I would rather not clutter the glossary with this sort of entry.  Already, it 
has clutter that should probably be removed so that once again it becomes a 
worthwhile read rather than turning into a dictionary of random terms (such as 
meta-path-finder, module spec, and regular-package).

Instead, there should probably be a FAQ entry or wiki entry on the ever 
evolving spoken cultural terminology:

   dunder --> double underscore
   stir   --> __str__
   repper --> __repr__
   rest --> .rst files or representational-state-transfer
   sequel -> sql
   gwid -> globally unique indentifier
   inker and decker -> incref and decef(larry hastings pronunciation)

--
nosy: +rhettinger

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Serhiy Storchaka]

Serhiy Storchaka  added the comment:

I think it shouldn't be added as a separate entry, but just mentioned in [1] 
and [2], and added to the index.

[1] https://docs.python.org/3/glossary.html#term-special-method
[2] https://docs.python.org/3/reference/datamodel.html#specialnames

--
keywords: +easy
nosy: +serhiy.storchaka
stage:  -> needs patch
type:  -> enhancement
versions: +Python 2.7, Python 3.6, Python 3.7

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Mariatta Wijaya]

Mariatta Wijaya  added the comment:

Anyway, +1 to adding dunder to glossary.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Mariatta Wijaya]

Mariatta Wijaya  added the comment:

> until we have something we can call a "mifflin".

Name of next GitHub bot? :P

--
nosy: +Mariatta

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Barry A. Warsaw]

Barry A. Warsaw  added the comment:

-1 until we have something we can call a "mifflin".

(Kidding of course!)

--
nosy: +barry

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31937] Add the term "dunder" to the glossary

[Brett Cannon]

New submission from Brett Cannon :

The term "dunder" is used out in the community regularly, but if you have never 
been exposed to it before it can seem a little odd without context.

--
assignee: docs@python
components: Documentation
messages: 305509
nosy: brett.cannon, docs@python
priority: normal
severity: normal
status: open
title: Add the term "dunder" to the glossary

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com