update some docs, rename a function, and remove an obsolete unused function