update documentation, fix a mini-bug, bump to v 1.2.1