small updates to documentation (note it seems like the func can return anything but 1 or 2 to ignore, but I added 0 to the documentation)