update linear.rst and associated doc files and function docstrings