Changeset 15500 for docs/Perl6/Spec

Timestamp:

03/07/07 10:06:22 (21 months ago)

Author:

audreyt

Message:

* In "foo".join(1,2,3), "foo" is the separator.
* index("foo", "bar") should really be -1, or something that

numifies to -1, lest the universe collapses.

Files:

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

docs/Perl6/Spec/Functions.pod

@@ -744 +744 @@
 =item join
 
- our Str multi method join ( @values: Str $separator = ' ' )
+ our Str multi method join ( $separator: @values )
  our Str multi join ( Str $separator = ' ', *@values )
 
 C<join> returns a single string comprised of all of the elements
-of C<@values>, separated by C<$separator>. The separator defaults
-to a single space.
+of C<@values>, separated by C<$separator>.
 
 Given an empty list, C<join> returns the empty string.
 
-To join with no separator you can use the C<[~]> reduce operator.
+The separator defaults to a single space.  To join with no separator,
+you can use the C<[~]> reduce operator.
 
 =item map
@@ -1136 +1136 @@
 
 If the substring is found, then the position of the first character of
-the substring is returned. If the substring is not found, then
-undef is returned.
+the substring is returned. If the substring is not found, then C<-1> is
+returned. [Conjecture: Could it be "-1 but Undef" or something?]
 
 =item pack