Clarify docs for some room state functions.