api: raise value error on invalid type for p()
update readme for new syntax
bump version