Document undocumented public items

Perhaps depending on #605.
Thanks. Done. Just FYI, this is mostly copy–pasted from the function docstring.