Hmm I realize after the fact that since the equivalent code snippet (which is actually the implementation) is a generator, then it is actually correct that prepare() isn't called until it is iterated. So the documentation for this is not incorrect.

Still, I think it would be better if the prepare() executes immediately rather than in the first iteration.