Document return values of some functions