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
