Was: [issue2001] Pydoc interactive browsing enhancement

[snip...]
This suggests that trace.find_strings() should probably be preserved
or properly deprecated.  If this is the case, should we fix bugs in
it?  Note that it currently has a bug because it ignores the coding
cookie when opening python source file.  Should this be fixed?

I freely admit that I have more questions than answers, so I would
like to hear from a wider audience.

If you deprecate it then you don't *have* to fix bugs in it. If we know it is used then we can't remove it without deprecation.

If the function is no longer needed but we want to exclude it from the public API, you could create a new function in the module, with a leading underscore name, fix the bugs in that and deprecate the old name.


Sorry, this meant to say "if the function is *still needed* (internally to the module) but we want to exclude it from the API"...

This would be a good approach to clarifying the public API of standard library modules. At least that way we could work towards a consistent policy.

All the best,

Michael

Alternatively you could make the old name an alias for the new one with a deprecation warning applied. That way the old name does get the bugfixes but is still deprecated.

Michael

_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/fuzzyman%40voidspace.org.uk




--

http://www.voidspace.org.uk/

READ CAREFULLY. By accepting and reading this email you agree,
on behalf of your employer, to release me from all obligations
and waivers arising from any and all NON-NEGOTIATED agreements,
licenses, terms-of-service, shrinkwrap, clickwrap, browsewrap,
confidentiality, non-disclosure, non-compete and acceptable use
policies (”BOGUS AGREEMENTS”) that I have entered into with your
employer, its partners, licensors, agents and assigns, in
perpetuity, without prejudice to my ongoing rights and privileges.
You further represent that you have the authority to release me
from any BOGUS AGREEMENTS on behalf of your employer.

_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com

Reply via email to