[issue1722] Undocumented urllib functions

[Senthil Kumaran]

Senthil Kumaran added the comment:

I had added a note in the documentation  c3656dca65e7 conveying that splittype, 
splithost should not be relied upon, and urlparse should be used for parsing. 
Also, Python3 does not include these in __all__ - It is in Python2 for 
backwards compatibility purposes. It is not possible provide deprecation 
warning to things we leave off from __all__ from subsequent versions of python.
I consider this request as resolved. Thanks!

--
resolution:  -> fixed
status: open -> closed
versions:  -Python 3.1, Python 3.2

___
Python tracker 

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

[issue1722] Undocumented urllib functions

[Roundup Robot]

Roundup Robot added the comment:

New changeset c3656dca65e7 by Senthil Kumaran in branch '2.7':
# 1722 - Add a note on urllib helper functions like splittype, splithost etc.
http://hg.python.org/cpython/rev/c3656dca65e7

--
nosy: +python-dev

___
Python tracker 

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

[issue1722] Undocumented urllib functions

[Nathan Housel]

Nathan Housel added the comment:

This has been fixed in trunk, the split* methods have documentation and appear 
in the module docs. 

See:
>>> help('urllib')

--
nosy: +plasticgap

___
Python tracker 

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

[issue1722] Undocumented urllib functions

[Mark Lawrence]

Changes by Mark Lawrence :


--
assignee: georg.brandl -> d...@python
nosy: +d...@python

___
Python tracker 

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

[issue1722] Undocumented urllib functions

[Terry J. Reedy]

Terry J. Reedy  added the comment:

When internal functions lack '_', perhaps the doc should say "xys,uie, and ooe 
are intentionally undocumented internal functions." Otherwise, how is one 
supposed to know?

--
nosy: +terry.reedy
versions:  -Python 2.6

___
Python tracker 

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

[issue1722] Undocumented urllib functions

[Ezio Melotti]

Changes by Ezio Melotti :


--
nosy: +ezio.melotti

___
Python tracker 

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

[issue1722] Undocumented urllib functions

[Brian Curtin]

Changes by Brian Curtin :


--
keywords: +easy
stage:  -> needs patch
type:  -> feature request
versions: +Python 2.6, Python 2.7, Python 3.1, Python 3.2 -Python 2.5

___
Python tracker 

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

[issue1722] Undocumented urllib functions

[Senthil]

Senthil added the comment:

> Georg Brandl added the comment:
> 
> There are quite a lot more functions in __all__, more than 10 split*
> functions... should they all be documented?
> 
> Also, isn't urlparse meant to do such tasks?

I agree. I too feel that not everything in the __all__ list should be
documented. And in this specific case of splithost, it is more appropriate for
the user to use urlparse.

--
nosy: +orsenthil

__
Tracker <[EMAIL PROTECTED]>

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

[issue1722] Undocumented urllib functions

[Georg Brandl]

Georg Brandl added the comment:

There are quite a lot more functions in __all__, more than 10 split*
functions... should they all be documented?

Also, isn't urlparse meant to do such tasks?

__
Tracker <[EMAIL PROTECTED]>

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

[issue1722] Undocumented urllib functions

[Guido van Rossum]

Changes by Guido van Rossum:


--
assignee:  -> georg.brandl
nosy: +georg.brandl

__
Tracker <[EMAIL PROTECTED]>

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

[issue1722] Undocumented urllib functions

[Barry A. Warsaw]

New submission from Barry A. Warsaw:

urllib.splithost() and .splittype() are included in urllib's __all__ but
are not documented in urllib's module documentation.  They are used
quite extensively in the module so they should be documented

__
Tracker <[EMAIL PROTECTED]>

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

[issue1722] Undocumented urllib functions

[Barry A. Warsaw]

Changes by Barry A. Warsaw:


--
components: Documentation
nosy: barry
priority: low
severity: normal
status: open
title: Undocumented urllib functions
versions: Python 2.5

__
Tracker <[EMAIL PROTECTED]>

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