From 4acbe0e514520d29faee330dede8c45246a166d9 Mon Sep 17 00:00:00 2001
From: Victor <victor@vsespb.ru>
Date: Sat, 17 Aug 2013 03:47:01 +0400
Subject: [PATCH] document decode_utf8 behaviour more precise

---
 Encode.pm | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Encode.pm b/Encode.pm
index aea404a..e4bf327 100644
--- 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">.