updated doc to make clear that combinators consume their generator argument