[Python-checkins] r73483 - peps/trunk/pep-0387.txt
benjamin.peterson
python-checkins at python.org
Fri Jun 19 22:55:54 CEST 2009
Author: benjamin.peterson
Date: Fri Jun 19 22:55:54 2009
New Revision: 73483
Log:
expand on public api
Modified:
peps/trunk/pep-0387.txt
Modified: peps/trunk/pep-0387.txt
==============================================================================
--- peps/trunk/pep-0387.txt (original)
+++ peps/trunk/pep-0387.txt Fri Jun 19 22:55:54 2009
@@ -28,9 +28,28 @@
Backwards Compatibility Rules
=============================
-This policy applies to all public APIs. These include the C-API, the
-standard library, and the core language including syntax and operation
-as defined by the reference manual.
+This policy applies to all public APIs. These include:
+
+- Syntax and behavior of these constructs as defined by the reference
+ manual
+
+- The C-API
+
+- Function, class, module, attribute, and method names and types.
+
+- The position and expected types of arguments and returned values.
+
+- Behavior of classes with regards to subclasses: the conditions under
+ which overridden methods are called.
+
+Others are explicity not part of the public API. They can change or
+be removed at any time in any way. These include:
+
+- Function, class, module, attribute, method, and C-API names and types that
+ are prefixed by "_" (except special names). The contents of these
+ can also are not subject to the policy.
+
+- Inheritance patterns of internal classes.
This is the basic policy for backwards compatibility:
More information about the Python-checkins
mailing list