DOC: shape_utils missing functions and misformatted returns

[wd60622]

Issue with current documentation:

A function or two from the __all__ of the shape_utils module is missing from this documentation page here

Also, the rendering of those functions' returns are a bit messy. For instance, here

Idea or request for content:

Add docs for all the __all__ functions and break out the return into two or more lines in order to render better