r29754 - docs/Perl6/Spec

Author: lwall
Date: 2010-02-16 21:14:32 +0100 (Tue, 16 Feb 2010)
New Revision: 29754

Modified:
   docs/Perl6/Spec/S02-bits.pod
   docs/Perl6/Spec/S06-routines.pod
   docs/Perl6/Spec/S07-iterators.pod
Log:
[Spec] s/getobj/getarg/ to be slightly more accurate


Modified: docs/Perl6/Spec/S02-bits.pod
===================================================================
--- docs/Perl6/Spec/S02-bits.pod	2010-02-16 17:33:04 UTC (rev 29753)
+++ docs/Perl6/Spec/S02-bits.pod	2010-02-16 20:14:32 UTC (rev 29754)
@@ -1863,8 +1863,8 @@
 
 If a C<Parcel> is bound to an individual parameter, the behavior
 depends on whether the parameter is "slicey" or "slurpy".  Positional
-parameters and slice parameters call C<.getobj> on the internal
-iterator and just return the next item or parcel without flattening.
+parameters and slice parameters call C<.getarg> on the internal
+iterator and just return the next syntactic argument (parcel or other object) without flattening.
 (Such a parcel transmutes to a C<Seq> object.)  Slurpy parameters
 call C<.get> on the internal iterator, which flattens any subparcels
 before pulling out the next item.  In either case, no bare parcel

Modified: docs/Perl6/Spec/S06-routines.pod
===================================================================
--- docs/Perl6/Spec/S06-routines.pod	2010-02-16 17:33:04 UTC (rev 29753)
+++ docs/Perl6/Spec/S06-routines.pod	2010-02-16 20:14:32 UTC (rev 29754)
@@ -1009,8 +1009,9 @@
     method foo (**@slice) { ... }
 
 The C<**> marker is just a variant of the C<*> marker that ends up
-requesting parcels when binding (underlyingly calling .getobj) rather
-than requesting individual elements as the flatening C<*> does.
+requesting parcels when binding (underlyingly calling C<.getarg>) rather
+than requesting individual elements as the flatening C<*> does (underlyingly
+calling C<.get>).
 
 =head2 Zero-dimensional argument list
 

Modified: docs/Perl6/Spec/S07-iterators.pod
===================================================================
--- docs/Perl6/Spec/S07-iterators.pod	2010-02-16 17:33:04 UTC (rev 29753)
+++ docs/Perl6/Spec/S07-iterators.pod	2010-02-16 20:14:32 UTC (rev 29754)
@@ -209,7 +209,7 @@
 
 This method provides list context to the iterator.
 
-=head2 method getobj {...}
+=head2 method getarg {...}
 
 Returns the next parcel or other object from the iterator without
 any flattening.  It is used both for binding to positional parameters
@@ -222,11 +222,11 @@
 No list should ever contain the C<EMPTY> exception, since iterational
 control flow should always terminate when that value is returned.
 
-Note: C<get> and C<getobj> must be atomic for any iterator shared
+Note: C<get> and C<getarg> must be atomic for any iterator shared
 by more than one thread, since it is likely that message passing is
 implemented in terms of them.
 
-=head2 method batchobj ($max?) {...}
+=head2 method batcharg ($max?) {...}
 
 Returns a batch of parcels/objects in some appropriate C<Positional> type that
 numerifies to the exact number of items returned. (The type may also
@@ -240,15 +240,15 @@
 This returns an iterator that always flattens by calling C<.get> internally
 (which discards any parcel structure, returning only the parcel's elements).
 The returned iterator will always return the same value regardless of
-whether you call C<.get> or C<.getobj>.
+whether you call C<.get> or C<.getarg>.
 
 =head2 method slice {...}
 
-This returns an iterator that always anti-flattens by calling C<.getobj> internally,
+This returns an iterator that always anti-flattens by calling C<.getarg> internally,
 then hiding any resulting parcel by turning it into a C<Seq> before returning it externally.
 A list of C<Parcel> is thereby transformed into a list of C<Seq>.
 The returned iterator will always return the same value regardless of
-whether you call C<.get> or C<.getobj>.
+whether you call C<.get> or C<.getarg>.
 
 =head1 The List::PushBack Role
 

• r29754 - docs/Perl6/Spec by pugs-commits