This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Clarify pod for bytes to/from utf8()
authorKarl Williamson <khw@cpan.org>
Wed, 14 Jun 2017 03:15:50 +0000 (21:15 -0600)
committerKarl Williamson <khw@cpan.org>
Wed, 14 Jun 2017 17:08:24 +0000 (11:08 -0600)
utf8.c

diff --git a/utf8.c b/utf8.c
index aeda0d7..d9ceef0 100644 (file)
--- a/utf8.c
+++ b/utf8.c
@@ -1913,8 +1913,8 @@ updates C<*lenp> to contain the new length.
 Returns zero on failure (leaving C<"s"> unchanged) setting C<*lenp> to -1.
 
 Upon successful return, the number of variants in the string can be computed by
-saving the value of C<*lenp> before the call, and subtracting the after-call
-value of C<*lenp> from it.
+having saved the value of C<*lenp> before the call, and subtracting the
+after-call value of C<*lenp> from it.
 
 If you need a copy of the string, see L</bytes_from_utf8>.
 
@@ -1987,11 +1987,11 @@ C<*lenp> are unchanged, and the return value is the original C<s>.
 
 Otherwise, C<*is_utf8p> is set to 0, and the return value is a pointer to a
 newly created string containing a downgraded copy of C<s>, and whose length is
-returned in C<*lenp>, updated.
+returned in C<*lenp>, updated.  The new string is C<NUL>-terminated.
 
 Upon successful return, the number of variants in the string can be computed by
-saving the value of C<*lenp> before the call, and subtracting the after-call
-value of C<*lenp> from it.
+having saved the value of C<*lenp> before the call, and subtracting the
+after-call value of C<*lenp> from it.
 
 =cut
 */
@@ -2057,7 +2057,7 @@ Returns a pointer to the newly-created string, and sets C<*lenp> to
 reflect the new length in bytes.
 
 Upon successful return, the number of variants in the string can be computed by
-saving the value of C<*lenp> before the call, and subtracting it from the
+having saved the value of C<*lenp> before the call, and subtracting it from the
 after-call value of C<*lenp>.
 
 A C<NUL> character will be written after the end of the string.