I made two changes, one in the example:
print_stats() if every(20); # every 20 cycles ($_ is 19, 39,
etc.)
and one in the docs, marked with >>>:
=head1 FUNCTION-ORIENTED INTERFACE
=head2 every( $number [, @id] )
=head2 every( seconds => $number [, @id] )
Returns true every C<$number> times it's called, or every time
C<$number> seconds have elapsed since the last time it was called.
Show quoted text>>> Note the first (0) cycle doesn't count.
I think that's OK, do you think it's understandable?
Also should I make the 0 count (for alternating table rows, for example)
optionally active? I haven't needed that but maybe you and others do.
Ted