Documentation improvements

Package is partially documented and passes a make check with one note