update readme to bring update into line with fresh install; also rebuild the binary release to incorporate all the new documentation