Changes by Sandro Tosi : ---------- nosy: +sandro.tosi versions: +Python 2.7, Python 3.2, Python 3.3 -Python 2.6 _______________________________________ Python tracker http://bugs.python.org/issue11009 _______________________________________

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 the module to fill in the missing methods in the doc, he'd know they are not to be exposed. ---------- _______________________________________ Python tracker http://bugs.python.org/issue11009 _______________________________________

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 functions are reimplemented outside the stdlib (e.g. see parse_credentials in pip.download). If the only reason for not exposing these is documentation clutter, surely there are approaches to minimise this. If the reason is that future implementations may change or remove them, that should be clarified. But since the basics of an url are unlikely to change, I don't see why these functions might be removed in the future. ---------- nosy: +vinay.sajip _______________________________________ Python tracker http://bugs.python.org/issue11009 _______________________________________

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 _______________________________________ Python tracker http://bugs.python.org/issue11009 _______________________________________