Subject: | Documentation improvements |
Three issues.
1. "every" is documented to have a parameter named "@id", but the
function and format of that parameter is undocumented.
2. It's clear how often "every" returns true, but there's no
documentation covering when it will return true for the first time. On
the first pass? Or after period passes?
pass every(3)
---- --------
1 T or F?
2 F or F?
3 F or T?
4 T or F?
5 F or F?
6 F or T?
3. I foresee the following pitfall being common
Given every(3)||every(4)
pass expected actual
---- -------- ------
1 F||F=F F||F=F
2 F||F=F F||F=F
3 T||F=T T =T
4 F||T=T F||F=F
5 F||F=F F||T=T
6 T||F=T T =T
7 F||F=F F||F=F
8 F||T=T F||F=F
Perhaps that should visited in the documentation.