Document undocumented public items

Perhaps depending on #605.
This is copy–pasted from the docstring. So perhaps the writer knew what he was writing.