[svn:parrot] r40913 - trunk/docs/project

[chromatic at svn.parrot.org]

Author: chromatic
Date: Tue Sep  1 20:41:08 2009
New Revision: 40913
URL: https://trac.parrot.org/parrot/changeset/40913

Log:
[docs] Clarified Parrot components not subject to our deprecation policy.

Modified:
   trunk/docs/project/support_policy.pod

Modified: trunk/docs/project/support_policy.pod
==============================================================================
--- trunk/docs/project/support_policy.pod	Tue Sep  1 11:55:26 2009	(r40912)
+++ trunk/docs/project/support_policy.pod	Tue Sep  1 20:41:08 2009	(r40913)
@@ -164,10 +164,27 @@
 
 =item * bytecode changes (opcode or core PMC removals, renames)
 
-=item * PARROT_API function changes
+=item * C<PARROT_API> function changes
 
 =item * PIR or PASM syntax changes
 
 =item * API changes in the compiler tools
 
 =back
+
+Please note that these features I<do not> require deprecation notices:
+
+=over 4
+
+=item * Parrot functions I<not> marked with C<PARROT_API>
+
+=item * The layout of Parrot's internal data structures
+
+=item * Parrot internals hidden behind a public API
+
+=back
+
+Note that all pointers passed to and returned from functions marked with
+C<PARROT_API> are considered opaque.  We do not guarantee backwards
+compatibility between monthly releases for the layout of these pointers;
+dereference them at your own risk.