[issue11009] urllib.splituser is not documented

Changes by Georg Brandl : -- status: open -> closed ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mai

[issue11009] urllib.splituser is not documented

Ezio Melotti added the comment: Doing that now will be backward incompatible, because people might be using these functions already even if they are not documented. An alias could be created, but I'm not sure it's worth doing it. -- nosy: +ezio.melotti status: pending -> open ___

[issue11009] urllib.splituser is not documented

anatoly techtonik added the comment: Why not to follow the convention and add underscore _ to the names to remove the ambiguity and future reports and confusion about that thees functions are not documented? -- status: closed -> pending ___ Python t

[issue11009] urllib.splituser is not documented

Vinay Sajip added the comment: Note that at least splituser is being used outside the stdlib: packaging (which was intended to be part of the stdlib) used it, and hence so do distutils2 and distlib (by sharing parts of their codebases). Of course these last two are outside the stdlib. Similar f

[issue11009] urllib.splituser is not documented

Senthil Kumaran added the comment: Sandro, I don't think is a required. Those functions serve the purpose of making the module code modular. They are helper functions for the module and are not really useful outside of it, when used standalone. Think about , splituser, splitpath, splitport etc e

[issue11009] urllib.splituser is not documented

Sandro Tosi added the comment: Hi Senthil, what do you think about "documenting" those methods are private ones in the urllib code (if not using _, at least a short comment above them)? at least we have a mark it's an implementation decision and in case someone has the crazy idea :) to scan t

[issue11009] urllib.splituser is not documented

Senthil Kumaran added the comment: splituser is an internal API. It has never been exposed through Docs anytime and there are good reasons for that too. We never want internal helper functions (even tough they don't startwith _) be exposed through docs as it may clutter the API Documentation.

[issue11009] urllib.splituser is not documented

Changes by Sandro Tosi : -- nosy: +sandro.tosi versions: +Python 2.7, Python 3.2, Python 3.3 -Python 2.6 ___ Python tracker ___ ___ Py

[issue11009] urllib.splituser is not documented

New submission from anatoly techtonik : I'm studying old code that uses urllib.splituser() call and can't find description of this function in Python 2.6.6 docs. -- assignee: docs@python components: Documentation messages: 127047 nosy: docs@python, techtonik priority: normal severity: n