improved correlation function docstrings