Merge pull request #10 from vsespb/master

document decode_utf8 behaviour more precise
dankogai · Aug 29, 2013 · 6b2f547 · 6b2f547
2 parents f95214d + 4acbe0e
commit 6b2f547
Showing 1 changed file with 2 additions and 1 deletion.
diff --git a/Encode.pm b/Encode.pm
@@ -572,9 +572,10 @@ as a sequence of octets.  Because all possible characters in Perl have a
 
   $string = decode_utf8($octets [, CHECK]);
 
-Equivalent to C<$string = decode("utf8", $octets [, CHECK])>.
+Similar but not identical to C<$string = decode("utf8", $octets [, CHECK])>.
 The sequence of octets represented by $octets is decoded
 from UTF-8 into a sequence of logical characters.
+Returns unaltered $octets value if it already has UTF-8 flag on.
 Because not all sequences of octets are valid UTF-8,
 it is quite possible for this function to fail.
 For CHECK, see L</"Handling Malformed Data">.