docstrings involving tau - are they right?