Changeset 9976 for docs/Perl6/FAQ

Timestamp:

04/17/06 07:28:36 (3 years ago)

Author:

gaal

Message:

r10025@sike: roo | 2006-04-17 08:27:16 +0300

• FAQ::Capture - copyediting. TODO: make consistent the use of "fail" vs. "error", in all our docs and not just here.

Files:

• docs/Perl6/FAQ/Capture.pod (modified) (6 diffs)

docs/Perl6/FAQ/Capture.pod

@@ -120 +120 @@
 
 However, regardless of single- or multi- dispatch, the argument list (Capture)
-can never have more than one invocants.  Typically, the presence of an invocant
+can never have more than one invocant.  Typically, the presence of an invocant
 indicates a method-call (which may fall back to a subroutine-call); the lack of
 invocant means a subroutine-call.
 
-    1.foo(2);  # Int.foo with 1 as "self"; if not found, fallback to foo(1, 2)
+    1.foo(2);  # Int.foo with 1 as "self"; if not
+               # found, fallback to foo(1, 2)
     foo(1: 2); # same as above
 
-    bar(1, 2); # never looks at Int.foo; calls &foo in lexical/package scope
+    bar(1, 2); # never looks at Int.bar; calls &bar
+               # in lexical/package scope
 
 Method/subroutine calls are determined by the presence of an invocant at the
@@ -266 +268 @@
 
   sub foo (@y is rw) { ... }
-  foo(1, 2, 3); # error: three arguments passed where one is expected
+  foo(1, 2, 3); # FAIL: three arguments passed where one is expected
 
 However, these forms are valid:
@@ -282 +284 @@
 modify the container itself, so this won't work:
 
-  @y.push(4);   # error: cannot find method: List.push
+  @y.push(4);   # FAIL: cannot find method: List.push
 
 On the other hand, because variables are initialized by their sigils,
@@ -300 +302 @@
 Array container bound to C<@y>:
 
-    $x.push(0); # error: cannot find method: List.push
+    $x.push(0); # FAIL: cannot find method: List.push
     @y.push(0); # works just fine
 
@@ -327 +329 @@
 However, they differ when you try to assign something into them:
 
-    $x = 42; # fails - Array doesn't handle scalar assignment
+    $x = 42; # FAIL  - Array doesn't handle scalar assignment
     @y = 42; # works - @y.elems is now 1
 
@@ -340 +342 @@
 
     $x := 41;
-    $x = 42;        # fails - Int doesn't handle scalar assignment either
+    $x = 42;        # FAIL - Int doesn't handle scalar assignment either
 
 =head2 Why