avoid explosion of multichar @with vals (Fixes #2)

add a test for this
documentation updates, as suggested by akerl_ on HN.
revise command line args

bump version to 1.0.1
make version 1.1.0