Windson Yang <wiwindson(a)outlook.com> added the comment:
Where are the documents actually?
----------
nosy: +Windson Yang
_______________________________________
Python tracker <report(a)bugs.python.org>
<https://bugs.python.org/issue9267>
_______________________________________
New submission from Xavier Morel:
Encountered this issue porting Python 2 code manipulating meta_path to Python 3.
In Python 2, meta_path is empty by default and its documentation specifically notes that:
> sys.meta_path is searched before any implicit default finders or sys.path.
As a result, sys.meta_path.append() works perfectly well and is overwhelmingly common[0].
In Python 3, this note was removed but the documentation does not specifically state default finders are present in meta_path, and the old code using sys.meta_path.append may now break as the default finders will silently take precedence on the custom ones if they believe they can do the job.
I'd like to add a warning to the Python 3 documentation (3.5+?) noting the presence of existing default loaders, and to the Python 2 documentation suggesting `sys.meta_path.insert(0, finder)` for future-proofing, would there be objections or issues?
[0] https://github.com/search?q=meta_path.append&type=Code&utf8=✓
----------
assignee: docs@python
components: Documentation
messages: 294919
nosy: docs@python, xmorel
priority: normal
severity: normal
status: open
title: Warn that meta_path is not empty
type: behavior
versions: Python 2.7, Python 3.5, Python 3.6
_______________________________________
Python tracker <report(a)bugs.python.org>
<http://bugs.python.org/issue30535>
_______________________________________
New submission from davidak <bugs.python.org+xdnb(a)davidak.de>:
It is described here: https://www.pythoncentral.io/time-a-python-function/
I have just tested it. Works as expected.
Best would be if timeit supports this natively.
----------
assignee: docs@python
components: Documentation
messages: 329079
nosy: davidak, docs@python
priority: normal
severity: normal
status: open
title: timeit documentation should have example with function arguments
versions: Python 3.6, Python 3.7
_______________________________________
Python tracker <report(a)bugs.python.org>
<https://bugs.python.org/issue35138>
_______________________________________
Cheryl Sabella <cheryl.sabella(a)gmail.com> added the comment:
@giampaolo.rodola, no problem. I intended this more as a general request rather than something for right now. If you do have any availability at some point, please keep this one in mind. Thanks!
----------
_______________________________________
Python tracker <report(a)bugs.python.org>
<https://bugs.python.org/issue22021>
_______________________________________
New submission from STINNER Victor <victor.stinner(a)haypocalc.com>:
The following example works on Python 2.7 and 3.2, but fails on Python 3.3:
-----------
import errno
import os
try:
os.rmdir("testdir")
except:
pass
os.mkdir("testdir")
try:
try:
os.mkdir("testdir")
except IOError as exc:
# If can't get proper access, then just forget about writing
# the data.
if exc.errno == errno.EACCES:
pass
else:
raise
except OSError as exc:
# Probably another Python process already created the dir.
if exc.errno == errno.EEXIST:
pass
else:
raise
except Exception:
print("PEP 3151 broke backward compatibility on such pattern!")
-----------
I noticed the problem while reading the changeset e4d44c2e8e81.
----------
assignee: docs@python
components: Documentation
messages: 146562
nosy: docs@python, flox, haypo, pitrou
priority: normal
severity: normal
status: open
title: PEP 3151 breaks backward compatibility: it should be documented
versions: Python 3.3
_______________________________________
Python tracker <report(a)bugs.python.org>
<http://bugs.python.org/issue13286>
_______________________________________
Giampaolo Rodola' <g.rodola(a)gmail.com> added the comment:
@cheryl.sabella don't have the bandwidth right now (traveling), sorry.
----------
_______________________________________
Python tracker <report(a)bugs.python.org>
<https://bugs.python.org/issue22021>
_______________________________________
New submission from Andrés Delfino <adelfino(a)gmail.com>:
IMHO, it's a good opportunity to advertise the convenience of breakpoint().
PR adds a mention.
----------
assignee: docs@python
components: Documentation
messages: 319796
nosy: adelfino, docs@python
priority: normal
severity: normal
status: open
title: doc Mention breakpoint() in debugger-related FAQ
type: enhancement
versions: Python 3.7, Python 3.8
_______________________________________
Python tracker <report(a)bugs.python.org>
<https://bugs.python.org/issue33882>
_______________________________________
New submission from Cheryl Sabella <cheryl.sabella(a)gmail.com>:
Please save this issue for a new contributor. If you have previously made a pull request to CPython, consider leaving this issue for someone else. Thanks!
Similar to what PR 9501 did for updating references in the docs from 3.6 to 3.7, an update needs to be done for 3.8.
----------
assignee: docs@python
components: Documentation
keywords: easy
messages: 335663
nosy: cheryl.sabella, docs@python
priority: normal
severity: normal
stage: needs patch
status: open
title: [good first issue] Update documentation for 3.8
type: enhancement
versions: Python 3.8
_______________________________________
Python tracker <report(a)bugs.python.org>
<https://bugs.python.org/issue36008>
_______________________________________
Cheryl Sabella <cheryl.sabella(a)gmail.com> added the comment:
@giampaolo.rodola, would you be able to provide a review of this doc change? Thanks!
----------
nosy: +cheryl.sabella, giampaolo.rodola
versions: -Python 3.6
_______________________________________
Python tracker <report(a)bugs.python.org>
<https://bugs.python.org/issue22021>
_______________________________________
New submission from Sanyam Khurana <sanyam.khurana01(a)gmail.com>:
While working on translations, I saw a minor grammatical error in `Doc/glossary.rst`:
```
* The default Python prompt of the interactive shell when entering
code for an indented code block ...
```
should be
```
* The default Python prompt of the interactive shell when entering the
code for an indented code block ...
```
Attaching the path with this.
----------
assignee: docs@python
components: Documentation
messages: 341665
nosy: CuriousLearner, docs@python
priority: normal
severity: normal
stage: needs patch
status: open
title: Minor grammatical fix in glossary.rst
type: enhancement
versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9
_______________________________________
Python tracker <report(a)bugs.python.org>
<https://bugs.python.org/issue36822>
_______________________________________