fix the docs. closes #1597