From ac1256e84658383144a004125119e392696fbe36 Mon Sep 17 00:00:00 2001
From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Sat, 15 Sep 2001 17:15:40 +0000
Subject: [PATCH] Document that the lc(), uc(), lcfirst(), ucfirst() are not
 yet complete.

p4raw-id: //depot/perl@12030
---
 pod/perltodo.pod    | 4 ++++
 pod/perlunicode.pod | 7 +++++++
 2 files changed, 11 insertions(+)

diff --git a/pod/perltodo.pod b/pod/perltodo.pod
index 35956e1..d6cd14b 100644
--- a/pod/perltodo.pod
+++ b/pod/perltodo.pod
@@ -69,6 +69,10 @@ B<\b> assertion wants to be overloaded by a function.
 
     Case Mappings? http://www.unicode.org/unicode/reports/tr21/
 
+lc(), uc(), lcfirst(), and ucfirst() work only for simple cases, where
+the mapping goes from a single Unicode character to another single
+Unicode character.  See lib/unicore/SpecCase.txt (and CaseFold.txt).
+
 =item *
 
 They have some tricks Perl doesn't yet implement like character
diff --git a/pod/perlunicode.pod b/pod/perlunicode.pod
index ba73eb3..8e12b6d 100644
--- a/pod/perlunicode.pod
+++ b/pod/perlunicode.pod
@@ -474,6 +474,13 @@ wide bit complement.
 
 =item *
 
+lc(), uc(), lcfirst(), and ucfirst() work for simple cases
+where the mapping goes from a single Unicode character to
+another single Unicode character.  More complex cases, where
+for example one character maps into several, are not yet implemented.
+
+=item *
+
 And finally, C<scalar reverse()> reverses by character rather than by byte.
 
 =back
-- 
2.7.4