[Python-checkins] r73483 - peps/trunk/pep-0387.txt

[benjamin.peterson]

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: