improve manual, add improvement note, other changes