maas-cli help is hard to read

[Diogo Matsubara]

ubuntu@lenovo-RD230-01:~$ maas-cli api maas node-group-interfaces new -h
usage: /usr/lib/python2.7/dist-packages/maascli/__main__.py api maas node-group-interfaces new
       [-h] uuid [data [data ...]]

:param ip: Static IP of the interface. :type ip: basestring (IP Address)
:param interface: Name of the interface. :type interface: basestring :param
management: The service(s) MAAS should manage on this interface. :type
management: Vocabulary `NODEGROUPINTERFACE_MANAGEMENT` :param subnet_mask:
Subnet mask, e.g. 255.0.0.0. :type subnet_mask: basestring (IP Address) :param
broadcast_ip: Broadcast address for this subnet. :type broadcast_ip:
basestring (IP Address) :param router_ip: Address of default gateway. :type
router_ip: basestring (IP Address) :param ip_range_low: Lowest IP address to
assign to clients. :type ip_range_low: basestring (IP Address) :param
ip_range_high: Highest IP address to assign to clients. :type ip_range_high:
basestring (IP Address)

positional arguments:
  uuid
  data

optional arguments:
  -h, --help show this help message and exit

The help for the data argument is hard to read since it doesn't have any line breaks.

[Gavin Panella (allenap)]

There's some fairly naive docstring reformatting code in maascli that
could probably be taught to split paragraphs on leading colons, as a
quick fix for now. A better fix is to parse the docstrings with
docutils and include a structured document in the API description, so
that maas-cli can render it more faithfully.