Author: larry
Date: Thu Jan 10 16:14:53 2008
New Revision: 14489

Modified:
   doc/trunk/design/syn/S02.pod

Log:
Clarification requested by moritz++


Modified: doc/trunk/design/syn/S02.pod
==============================================================================
--- doc/trunk/design/syn/S02.pod        (original)
+++ doc/trunk/design/syn/S02.pod        Thu Jan 10 16:14:53 2008
@@ -548,6 +548,10 @@
 also ask for the total string length of an array's elements, in bytes,
 codepoints or graphemes, using these methods C<.bytes>, C<.codes> or C<.graphs>
 respectively on the array.  The same methods apply to strings as well.
+(Note that C<.bytes> is not guaranteed to be well-defined when the encoding
+is unknown.  Similarly, C<.codes> is not well-defined unless you know which
+canonicalization is in effect.  Hence, both methods allow an optional argument
+to specify the meaning exactly if it cannot be known from context.)
 
 There is no C<.length> method for either arrays or strings, because C<length>
 does not specify a unit.

Reply via email to