DOC: move matfuncs docstrings to user-visible functions

This affects the docstrings of matrix functions implemented using higham's inverse scaling and squaring algorithms, including `logm` and `fractional_matrix_power`.

See also https://github.com/scipy/scipy/pull/3540