From: Rafael Garcia-Suarez <rgarciasuarez@gmail.com>
Date: Mon, 12 Mar 2007 21:22:55 +0000 (+0000)
Subject: Remove notes about experimental functions in the utf8 module.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=7edb8f2b4268bb093066522fea77b0df6cc903bd;p=p5sagit%2Fp5-mst-13.2.git

Remove notes about experimental functions in the utf8 module.
Also, document that the internal utf8 functions can be used
without loading utf8.pm. (Suggested by Juerd)

p4raw-id: //depot/perl@30555
---

diff --git a/lib/utf8.pm b/lib/utf8.pm
index f8c1c10..ac73aa1 100644
--- a/lib/utf8.pm
+++ b/lib/utf8.pm
@@ -130,9 +130,6 @@ B<Note that this function does not handle arbitrary encodings.>
 Therefore Encode is recommended for the general purposes; see also
 L<Encode>.
 
-B<NOTE:> this function is experimental and may change or be removed
-without notice.
-
 =item * utf8::encode($string)
 
 Converts in-place the character sequence to the corresponding octet
@@ -155,9 +152,6 @@ B<Note that this function does not handle arbitrary encodings.>
 Therefore Encode is recommended for the general purposes; see also
 L<Encode>.
 
-B<NOTE:> this function is experimental and may change or be removed
-without notice.
-
 =item * $flag = utf8::is_utf8(STRING)
 
 (Since Perl 5.8.1)  Test whether STRING is in UTF-8 internally.
@@ -179,10 +173,10 @@ cleared.  See L<perlunicode> for more on the UTF8 flag and the C API
 functions C<sv_utf8_upgrade>, C<sv_utf8_downgrade>, C<sv_utf8_encode>,
 and C<sv_utf8_decode>, which are wrapped by the Perl functions
 C<utf8::upgrade>, C<utf8::downgrade>, C<utf8::encode> and
-C<utf8::decode>.  Note that in the Perl 5.8.0 and 5.8.1 implementation
-the functions utf8::is_utf8, utf8::valid, utf8::encode, utf8::decode,
-utf8::upgrade, and utf8::downgrade are always available, without a
-C<require utf8> statement-- this may change in future releases.
+C<utf8::decode>.  Also, the functions utf8::is_utf8, utf8::valid,
+utf8::encode, utf8::decode, utf8::upgrade, and utf8::downgrade are
+actually internal, and thus always available, without a C<require utf8>
+statement.
 
 =head1 BUGS