Changeset 19478 for docs

Timestamp:

01/14/08 21:07:19 (12 months ago)

Author:

lwall

Message:

Some updates to reflect distinctions between lexical graphemes/codepoints/bytes scopes

Files:

• docs/Perl6/Spec/Functions.pod (modified) (4 diffs)

docs/Perl6/Spec/Functions.pod

@@ -13 +13 @@
                 Mark Stosberg <mark@summersault.com>
  Date:          12 Mar 2005
- Last Modified: 10 Jan 2008
- Version:       16
+ Last Modified: 14 Jan 2008
+ Version:       17
 
 This document attempts to document the list of builtin functions in Perl 6.
@@ -1113 +1113 @@
 until there is no further work to be done.
 
+Note that this function is really only applicable when dealing with codepoint
+strings.  Grapheme strings are normally processed at a higher abstraction level
+that is independent of normalization, and are lazily normalized into the
+desired normalization when transferred to lexical scopes or handles that care.
+
 =item samecase
 
@@ -1154 +1159 @@
 =item codes
 
- our Int multi method codes ( Str $string: $nf = "C") is export
+ our Int multi method codes ( Str $string: $nf = $?NF) is export
 
 Returns the number of codepoints in the string if it were canonicalized the
@@ -1162 +1167 @@
 =item bytes
 
- our Int multi method bytes ( Str $string: $nf = "C", $enc = "UTF-8") is export
+ our Int multi method bytes ( Str $string: $nf = $?NF, $enc = $?ENC) is export
 
 Returns the number of bytes in the string if it were encoded in the