No code change -- just trying to document the return conditions for all

the internal comparison routines.