[ZPT] Re: Name of total sequence length

[hans]

Dieter Maurer wrote:

> 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.

Please note, that not all users are ignorant of abstract data types.
sequence_length and batch_length makes sense to me.
cheers hans
-------------------------------------------------------------
Who's got only a hammer sees the world as a nail
hans augustin  (software developer)           hans@beehive.de
beehive elektronische medien GmbH       http://www.beehive.de
phone: +49 30 847-82 0                  fax: +49 30 847-82 299