[ZPT] Re: Name of total sequence length

[Dieter Maurer]

Steve Alexander writes:
 > Dieter Maurer wrote:
 > > 
 > >  > I'd prefer total_length to sequence_length, because "sequence" does not 
 > >  > feature in the external API of ZTUtils, and it would be a shame to add 
 > >  > it now ;-)  (nasty flashbacks to DTML...)
 >  >
 > > The first parameter of the constructor is called "sequence".
 > 
 > That may be, but a user of Page Templates may well not know Python, and 
 > may well not read the code of the constructor.
But the constructor needs to be documented!
It is essential to know, how a "Batch" is constructed, not only
what one can do with it once it is there.

 > I'm suggesting a name that is meaningful to someone thinking about 
 > displaying batches of information. We have the length of the current 
 > batch, and the total length.
And what should this "total" be?

It must refer to something: the sequence, the batch forms part of.

 > For such a person, there is currently no use of the word "sequence". I 
 > don't see why we should introduce one now.
See above.


Dieter