added missing test, and some docs.