This is one of many functions that doesn't contain docstrings. Each function needs at least a one line description, though a CLI Example is not necessarily required unless usage isn't obvious. With all the new additions lately, that is likely to change.