clarified .when docs. closes #433