README and spec updated