use :const: and ~ in doctsrings
add exception info to docstrings, add some exception raising for completeness
move Mapping-detection earlier in coeffs methods