[issue24172] Errors in resource.getpagesize module documentation

2015-11-17 Thread John Runyon 

John Runyon added the comment:

This is a duplicate of 20468, which has a patch submitted (over a year ago).

--
nosy: +jrunyon

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

[issue20468] resource module documentation is incorrect

2015-11-17 Thread John Runyon 

John Runyon added the comment:

*bump*.

This flat-out wrong documentation has already misled several people, and has 
had a proposed patch with no comments for over a year.

--
nosy: +jrunyon

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

[issue24256] threading.Timer is not a class

2015-11-17 Thread John Runyon 

John Runyon added the comment:

New proposed patch.

I understand not wanting to document an "internal only name", except that in 
this case it rather needs to be documented. I would strongly prefer Angad's 
patch to mine because you do, at times, need to know the actual name of the 
class being used -- and the documentation should not force people to dig 
through the source code to find that.

--
Added file: http://bugs.python.org/file41062/timer.diff

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

[issue24256] threading.Timer is not a class

2015-05-20 Thread John Runyon 

New submission from John Runyon:

the documentation 
(https://docs.python.org/2/library/threading.html#threading.Timer) lists 
"threading.Timer" as a class. It is not, which means that (for example) you can 
not use it in isinstance(). "threading._Timer" is a class. 
"threading.Timer(...).__class__" is a class. "threading.Timer" is a function.

>>> import threading
>>> threading.Timer


--
assignee: docs@python
components: Documentation
messages: 243735
nosy: docs@python, jrunyon
priority: normal
severity: normal
status: open
title: threading.Timer is not a class
versions: Python 2.7

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

[issue24256] threading.Timer is not a class

2015-05-21 Thread John Runyon 

John Runyon added the comment:

Concise documentation isn't my forte, but my confusion would've been avoided 
with a note that "for historical reasons, threading.Timer is actually a factory 
function for the underlying class threading._Timer" or something along those 
lines.

--

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