regen headers

p4raw-id: //depot/perl@18781

1 files changed, 7 insertions, 4 deletions

diff --git a/pod/perlapi.pod b/pod/perlapi.pod
index 36e50cb336..5945becc84 100644
--- a/pod/perlapi.pod
+++ b/pod/perlapi.pod
@@ -4708,6 +4708,9 @@ Converts a string C<s> of length C<len> from ASCII into UTF8 encoding.
 Returns a pointer to the newly-created string, and sets C<len> to
 reflect the new length.
 
+If you want to convert to UTF8 from other encodings than ASCII,
+see sv_recode_to_utf8().
+
 NOTE: this function is experimental and may change or be
 removed without notice.
 
@@ -4758,10 +4761,10 @@ Found in file utf8.c
 
 =item is_utf8_string
 
-Returns true if first C<len> bytes of the given string form a valid UTF8
-string, false otherwise.  Note that 'a valid UTF8 string' does not mean
-'a string that contains UTF8' because a valid ASCII string is a valid
-UTF8 string.
+Returns true if first C<len> bytes of the given string form a valid
+UTF8 string, false otherwise.  Note that 'a valid UTF8 string' does
+not mean 'a string that contains code points above 0x7F encoded in
+UTF8' because a valid ASCII string is a valid UTF8 string.
 
 	bool	is_utf8_string(U8 *s, STRLEN len)