these docstrings aren't quite right.