actually a lot of lies in this file's docstrings