Updated the return values (comments/docs) of a couple of methods.