Expand function documentation to include more sections

[lawalter]

Include @returns, @examples and @seealso. If expanding descriptions, use @description and/or @details.

[lawalter]

Create a @family of plotting functions.