[issue3430] httplib.HTTPResponse documentations inconsistent

[Demian Brecht]

Change by Demian Brecht :


--
nosy:  -demian.brecht

___
Python tracker 

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

[issue3430] httplib.HTTPResponse documentations inconsistent

[Demian Brecht]

Changes by Demian Brecht demianbre...@gmail.com:


--
nosy: +dbrecht

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

[issue3430] httplib.HTTPResponse documentations inconsistent

[M. Volz]

Changes by M. Volz marie...@gmail.com:


--
nosy: +mvolz

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

[issue3430] httplib.HTTPResponse documentations inconsistent

[Terry J. Reedy]

Terry J. Reedy added the comment:

Docs are still as deficient in 3.3, and so I presume in 3.4.

Part of the discrepancy between the first two lists is that data attributes 
msg, version, status, and reason are instance-only attributes.

#19154 is (now) about improving fileno doc. That, some other methods, are 
missing doctrings, making help(method) useless.

A big change in 3.x is that HTTPResponse now subclasses io.RawIOBase and hence 
inherits or implements even more (undocumented) methods than listed here. I 
suppose they could be documented by reference to the base class, if that is the 
normal procedure when subclassing.

--
dependencies: +AttributeError: 'NoneType' in http/client.py when using select 
when file descriptor is closed.
nosy:  -georg.brandl
versions: +Python 3.4 -Python 3.2

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

[issue3430] httplib.HTTPResponse documentations inconsistent

[Éric Araujo]

Changes by Éric Araujo mer...@netwok.org:


--
nosy: +eric.araujo

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue3430
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue3430] httplib.HTTPResponse documentations inconsistent

[Ezio Melotti]

Changes by Ezio Melotti ezio.melo...@gmail.com:


--
nosy: +ezio.melotti
resolution: accepted - 
versions: +Python 3.3 -Python 2.6, Python 3.1

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue3430
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue3430] httplib.HTTPResponse documentations inconsistent

[ThomasH]

ThomasH thomas.bugzi...@gmx.net added the comment:

Still applies. Neither the 2.7 documentation has changed (judging from the 
current online dev docs), nor the implementation (judging from current svn). So 
my first two lists are still valid. I cannot comment on the third, as I don't 
have a 2.7 installation at hand, or will have any time soon.

--
status: pending - open

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue3430
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue3430] httplib.HTTPResponse documentations inconsistent

[Senthil Kumaran]

Senthil Kumaran orsent...@gmail.com added the comment:

Yes, I know httplib documentation needs improvement. There is a great deal of 
documentation in the module itself. A lot can be .rst'ifed.

--
assignee: georg.brandl - orsenthil
nosy: +orsenthil
resolution:  - accepted
stage:  - needs patch
versions: +Python 2.6, Python 2.7, Python 3.1, Python 3.2 -Python 2.5

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue3430
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue3430] httplib.HTTPResponse documentations inconsistent

[ThomasH]

New submission from ThomasH [EMAIL PROTECTED]:

The library reference documentation of httplib.HTTPResponse does not
match up with the online help documentation, or with the dir()
information of a particular instance.

E.g. the list of public features in the library reference
(http://docs.python.org/lib/httpresponse-objects.html) is:
- read
- getheader
- getheaders
- msg
- version
- status
- reason

From the online documentation (with 'help(httplib.HTTPResponse)'):
- begin
- close
- getheader
- getheaders
- isclosed
- read

And from a class instance (via 'dir(httpResponseInstance)'):
- 'begin',
- 'chunk_left',
- 'chunked',
- 'close',
- 'debuglevel',
- 'fp',
- 'getheader',
- 'getheaders',
- 'isclosed',
- 'length',
- 'msg',
- 'read',
- 'reason',
- 'status',
- 'strict',
- 'version',
- 'will_close'

--
assignee: georg.brandl
components: Documentation
messages: 70158
nosy: ThomasH, georg.brandl
severity: normal
status: open
title: httplib.HTTPResponse documentations inconsistent
versions: Python 2.5

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue3430
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com