Re: [PATCH] perlreref.pod tweaks

Message-ID: <20030812035927.GJ7914@gytha.anu.edu.au>

plus explain "Titlecase".

p4raw-id: //depot/perl@20625

diff --git a/pod/perlreref.pod b/pod/perlreref.pod
index 9f083c7..c6c7752 100644 (file)
--- a/pod/perlreref.pod
+++ b/pod/perlreref.pod
@@ -87,10 +87,12 @@ These work as in normal strings.
    \l  Lowercase next character
    \u  Uppercase next character
    \L  Lowercase until \E
-   \U  Uppercase until \E
+   \U  Titlecase until \E
    \Q  Disable pattern metacharacters until \E
    \E  End case modification
 
+For Titlecase, see L</Titlecase>.
+
 This one works differently from normal strings:
 
    \b  An assertion, not backspace, except in a character class
@@ -211,7 +213,8 @@ Captured groups are numbered according to their I<opening> paren.
    lc          Lowercase a string
    lcfirst     Lowercase first char of a string
    uc          Uppercase a string
-   ucfirst     Uppercase first char of a string
+   ucfirst     Titlecase first char of a string
+
    pos         Return or set current match position
    quotemeta   Quote metacharacters
    reset       Reset ?pattern? status
@@ -219,6 +222,16 @@ Captured groups are numbered according to their I<opening> paren.
 
    split       Use regex to split a string into parts
 
+The first four of these are identical to the escape sequences \l, \u,
+\L, and \U.  For Titlecase, see L</Titlecase>.
+
+=head1 Terminology
+
+=head2 Titlecase
+
+Unicode concept which most often is equal to uppercase, but for
+certain characters like the German "sharp s" there is a difference.
+
 =head1 AUTHOR
 
 Iain Truskett.