After all the discussion about Stas's bug, I thought it would be handy to provide docstrings to the two configuration variables in question. Just pushed that patch.

We might consider expanding on the material in the manual, as well; I am not sure a real novice would understand the implications. If you like, I will do that.

cheers, r