I'm reading the bungee book and I am often (momentarily) confused by
the term "iterator".  I noticed that the API documentation on the
prototype site uses the same term.  If this really is the proper term
in the Javascript language, thats fine.  I'll shut up.  For me, I
think of "iterator" as an object that iterates over another object --
like in C++.  It seems like there must be a better term than iterator.

As a second issue, I'd like to see these 'iterators' properly
prototyped themselves.  So, instead of:

inject(accumulator, iterator[, context]) -> accumulatedValue

I'd like to see:

inject(accumulator, func(accumulator, element[, index])[, context]) ->
accumulatedValue

After going through the documentation, I can now glance at this
specification and immediately remember how to use it, what arguments
the 'iterator' takes, etc.  Whereas before, I'm likely to forget that
index is passed along too, etc.

Do others think this would help?  If so, I'd like to try and change
the Enumerator functions to start with.  Maybe others can change other
sections.

But, before I start, I wanted to come to some consensus on what to
call the function.

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"Prototype: Core" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/prototype-core?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to