[albatross-users] al-for and Template frustration and confusion

[Sheila King]

--On Sunday, June 29, 2003 3:49 PM +1000 Dave Cole 
<djc at object-craft.com.au> wrote:

>>>>>> "Sheila" == Sheila King <sheila at thinkspot.net> writes:
>
> Sheila> The documentation did not make clear to me that, by using the
> Sheila> al-for tag, that albatross was creating a ListIterator type
> Sheila> that had these methods which I could use.
>
> [snip]
>
> Sheila> I would suggest adding some language to the docs which states
> Sheila> that, by using the al-for tag, that albatross instantiates a
> Sheila> ListIterator object, as defined by the class definition in the
> Sheila> tags.py file, and that the ListIterator object will have the
> Sheila> following methods available to it ...blah blah...
>
> In response to this and the concerns from Matt Goodall I have added
> some more content to the start of the <al-for> reference.  Can you
> please look at the following and tell me if it helps?
>
>
> http://www.object-craft.com.au/projects/albatross/albatross/tag-for.html
>
> - Dave
>

Dave, I think this is much clearer now. This makes all the difference in 
the world, IMHO:

The tag uses an instance of the ListIterator (5.3.7.8) identified in the 
local namespace by the iter (5.3.7.5) attribute to iterate over the 
sequence defined by the expression in the expr (5.3.7.3) attribute.

Having that practically at the beginning, especially with references to the 
rest of the documentation, makes it much clearer what exactly is going on.

Thanks for listening,

-- 
Sheila King
http://www.thinkspot.net/sheila/
http://www.k12groups.org