From dbfbbfa1fdf1a08e6425c9860827d0589f004f33 Mon Sep 17 00:00:00 2001
From: Karl Williamson <public@khwilliamson.com>
Date: Thu, 5 Jan 2012 15:42:08 -0700
Subject: [PATCH] perlunicode: Discourage use of is_utf8_char()

---
 pod/perlunicode.pod | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/pod/perlunicode.pod b/pod/perlunicode.pod
index b50ae93..4f7fb85 100644
--- a/pod/perlunicode.pod
+++ b/pod/perlunicode.pod
@@ -1523,13 +1523,14 @@ designed to be a one-way street).
 
 =item *
 
-C<is_utf8_char(s)> returns true if the pointer points to a valid UTF-8
-character.
+C<is_utf8_string(buf, len)> returns true if C<len> bytes of the buffer
+are valid UTF-8.
 
 =item *
 
-C<is_utf8_string(buf, len)> returns true if C<len> bytes of the buffer
-are valid UTF-8.
+C<is_utf8_char(s)> returns true if the pointer points to a valid UTF-8
+character.  However, this function should not be used because of
+security concerns.  Instead, use C<is_utf8_string()>.
 
 =item *
 
-- 
1.8.3.1