[svn:parrot] r40088 - in trunk: . docs/pdds src/string

[NotFound at svn.parrot.org]

Author: NotFound
Date: Tue Jul 14 20:24:28 2009
New Revision: 40088
URL: https://trac.parrot.org/parrot/changeset/40088

Log:
[DEPRECATED] add deprecation notices for Parrot_str_free, TT #826

Modified:
   trunk/DEPRECATED.pod
   trunk/docs/pdds/pdd28_strings.pod
   trunk/src/string/api.c

Modified: trunk/DEPRECATED.pod
==============================================================================
--- trunk/DEPRECATED.pod	Tue Jul 14 20:06:16 2009	(r40087)
+++ trunk/DEPRECATED.pod	Tue Jul 14 20:24:28 2009	(r40088)
@@ -272,6 +272,13 @@
 
 * = item may be kept but reimplemented.
 
+=item Parrot_str_free [eligible in 1.5]
+
+L<https://trac.parrot.org/parrot/ticket/826>
+
+This function was an attempt of optimization, but is error prone. Let the
+garbage collector take care.
+
 =back
 
 =head1 Compiler tools

Modified: trunk/docs/pdds/pdd28_strings.pod
==============================================================================
--- trunk/docs/pdds/pdd28_strings.pod	Tue Jul 14 20:06:16 2009	(r40087)
+++ trunk/docs/pdds/pdd28_strings.pod	Tue Jul 14 20:24:28 2009	(r40088)
@@ -575,10 +575,6 @@
 Terminate and clean up Parrot's string subsystem, including string allocation
 and garbage collection.
 
-=head4 Parrot_str_free (was string_free)
-
-Free the string's header.
-
 =head4 string_max_bytes
 
 Calculate the number of bytes needed to hold a given number of characters in a
@@ -642,6 +638,10 @@
 
 Is the same as Parrot_str_split.
 
+=head4 Parrot_str_free (was string_free)
+
+Unsafe and unuseful, let the garbage collector take care.
+
 =head3 String PMC API
 
 The String PMC provides a high-level object interface to the string

Modified: trunk/src/string/api.c
==============================================================================
--- trunk/src/string/api.c	Tue Jul 14 20:06:16 2009	(r40087)
+++ trunk/src/string/api.c	Tue Jul 14 20:24:28 2009	(r40088)
@@ -235,6 +235,8 @@
 STRING's buffer &c.  Use this only if you I<know> that nothing else has stored
 the STRING elsewhere.
 
+This function has been deprecated.
+
 =cut
 
 */