fix readme; fix a subtle bug (see http://stackoverflow.com/a/8528606)