README and spec fixes