update docs for filename, closes #233

and some fixes