more instructions and one bug fix