[albatross-users] <al-for> and ListIterator in current and new documentation

[Matt Goodall]

On Fri, 2003-06-20 at 21:38, Sheila King wrote:

> I would suggest adding some language to the docs which states that, by 
> using the al-for tag, that albatross instantiates a ListIterator object, as 
> defined by the class definition in the tags.py file, and that the 
> ListIterator object will have the following methods available to it ...blah 
> blah...

Sorry to disagree but I think the current <al-for> documentation is
reasonably clear. The iter attribute is described as "... the name of
the ListIterator (5.3.7.8) ...". ListIterator is also described in the
<al-for> section.

More importantly ... I read the <al-for> documentation from the 1.10pre1
distribution and I would say that the new documentation is less clear on
this matter than the 1.0.1 version. The 2nd paragraph of section 5.3.7
would be an ideal place to mention the ListIterator.

Cheers, Matt

-- 
Matt Goodall
Pollenation Internet Ltd, http://www.pollenation.net
e: matt at pollenation.net