merged README.md from upstream/master
allow - in named parameters
adapted spec to allow for - in named parameters