incl. minimal documentation and a pair of tests

Ignore-this: fb34b56a433476c6bbd8c699bd584d20

darcs-hash:e65a5020b5392fbb6be1cd4d3190d4e3fbe00f52

if-first-time not declared obsolete
documentation strings for (iter:display-iterate-clauses) complete

darcs-hash:ec77c32317019efeb6b97b340d102bc00f2fe141

darcs-hash:bc746991bd3bbb39b86b4249d2bb71bf6d8f9a3e

Move section on predicate (first-time-p) outside of gathering clauses
Various typos and some clarifications

darcs-hash:5b5854a2ee03c6d4bb12991029e4eb351be51ad8

darcs-hash:b962fc87c862aad8a62414a2085d852ef70f438c

darcs-hash:021d290a252268456b0f4417b6315c33795e25c9

darcs-hash:3bfae4ec6f2a31b3d6a2e9c0ff18b37f18c637ab

darcs-hash:09cedafbc6986fd35e1f73865b8e5ef6103c13c7

darcs-hash:141034780682dd0b2ecad11946f5c7f716406a6d

darcs-hash:60aa3d2a88d512f3d26c6a6623c25721a02bbf4e