Please parse and display @params and @returns of methods separate from description text

[brettnolan]

It would be really nice if the pdoc would parse and display thinks like the @params and @returns separately (and appropriately) from the rest of the description content.

So for instance, if my descriptor looked like:

@staticmethod
def version_str(version):
    """
    Retrieves the current version string of the software loaded on the DUT.
    @param version - A dictionary containing version information
    @return: Return a string form of the version.
    """

It would show separate Parameters and Returns sections in the output like:

def version_str(version)

Retrieves the current version string of the software loaded on the DUT.

Parameters

    version    A dictionary containing version information

Returns

    Return a string form of the version.

[BurntSushi]

Dupe of #59.