updated docs; fixes #252