Improve optin documentation in README and doc string.

Also add some case-insensitivity tests.