Supply more details on how lc/uc/lcfirst/ucfirst are

not yet fully implemented.

p4raw-id: //depot/perl@12037

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index fec1ce4..0761412 100644 (file)
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -5456,9 +5456,8 @@ otherwise.
 Returns an uppercased version of EXPR.  This is the internal function
 implementing the C<\U> escape in double-quoted strings.  Respects
 current LC_CTYPE locale if C<use locale> in force.  See L<perllocale>
-and L<perlunicode>.  Under Unicode it uses the standard Unicode
-uppercase mappings.  (It does not attempt to do titlecase mapping on
-initial letters.  See C<ucfirst> for that.)
+and L<perlunicode>.  It does not attempt to do titlecase mapping on
+initial letters.  See C<ucfirst> for that.
 
 If EXPR is omitted, uses C<$_>.
 

diff --git a/pod/perlunicode.pod b/pod/perlunicode.pod
index 3f2e7f8..63ad011 100644 (file)
--- a/pod/perlunicode.pod
+++ b/pod/perlunicode.pod
@@ -476,8 +476,13 @@ wide bit complement.
 
 lc(), uc(), lcfirst(), and ucfirst() work only for some of the
 simplest 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.
+to another single Unicode character, and where the mapping does not
+depend on surrounding characters, or on locales.  More complex cases,
+where for example one character maps into several, are not yet
+implemented.  See the Unicode Technical Report #21, Case Mappings,
+for more details.  The Unicode::UCD module (part of Perl since 5.8.0)
+casespec() and casefold() interfaces supply information about the more
+complex cases.
 
 =item *