clarified .when docs. closes #433
updated readme-src, and tiny doc tweak
Merge pull request #448 from stiff/master

Clarified Bacon.when docs. Closes #433