homepage

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: str.translate docstring doesn't mention that 'table' can be None
Type: Stage:
Components: Documentation Versions: Python 2.7
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: mark.dickinson Nosy List: docs@python, mark.dickinson, petri.lehtinen, python-dev
Priority: normal Keywords: patch

Created on 2011年05月24日 05:14 by mark.dickinson, last changed 2022年04月11日 14:57 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
str_translate_docstring.patch petri.lehtinen, 2011年05月26日 06:49 Fix docstring of str.translate
str_translate_docstring_2.patch petri.lehtinen, 2011年05月31日 11:01 Different wording
Messages (6)
msg136720 - (view) Author: Mark Dickinson (mark.dickinson) * (Python committer) Date: 2011年05月24日 05:14
In Python 2.6 and 2.7, str.translate accepts None as a first argument. That's documented in the docs, but not in the str.translate docstring.
msg137353 - (view) Author: Petri Lehtinen (petri.lehtinen) * (Python committer) Date: 2011年05月31日 09:45
I added a patch a few days ago. How does it look?
msg137356 - (view) Author: Petri Lehtinen (petri.lehtinen) * (Python committer) Date: 2011年05月31日 11:01
After discussing with Ezio Melotti, I attached another patch with a different wording.
Mark: As a native English speaker, which one you prefer?
msg137645 - (view) Author: Mark Dickinson (mark.dickinson) * (Python committer) Date: 2011年06月04日 14:54
Thanks for the patches! Here's a slight expansion of the wording on your second patch:
 Return a copy of the string S, where all characters occurring
 in the optional argument deletechars are removed, and the
 remaining characters have been mapped through the given
 translation table, which must be a string of length 256 or None.
 If the table argument is None, no translation is applied and
 the translation simply removes the characters in deletechars.
What do you think?
msg137657 - (view) Author: Petri Lehtinen (petri.lehtinen) * (Python committer) Date: 2011年06月04日 18:08
> What do you think?
Sounds very good to my native Finnish ears :)
msg139028 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2011年06月25日 09:00
New changeset 60b3a5615c4e by Mark Dickinson in branch '2.7':
Issue #12164: Document (in docstring) that str.translate accepts None for the first argument.
http://hg.python.org/cpython/rev/60b3a5615c4e 
History
Date User Action Args
2022年04月11日 14:57:17adminsetgithub: 56373
2011年06月25日 09:01:08mark.dickinsonsetstatus: open -> closed
resolution: accepted -> fixed
2011年06月25日 09:00:19python-devsetnosy: + python-dev
messages: + msg139028
2011年06月04日 18:21:34rhettingersetresolution: accepted
2011年06月04日 18:08:50petri.lehtinensetmessages: + msg137657
2011年06月04日 14:54:44mark.dickinsonsetassignee: docs@python -> mark.dickinson
messages: + msg137645
2011年05月31日 11:01:36petri.lehtinensetfiles: + str_translate_docstring_2.patch

messages: + msg137356
2011年05月31日 09:45:42petri.lehtinensetmessages: + msg137353
2011年05月26日 06:49:53petri.lehtinensetfiles: + str_translate_docstring.patch
nosy: + petri.lehtinen
keywords: + patch
2011年05月24日 05:14:44mark.dickinsoncreate

AltStyle によって変換されたページ (->オリジナル) /