Fix auto-generated REST API formatting

Fix an issue we have with the formatting of our auto-generated
REST API documentation. Sphinxcontrib-pecanwsme does not like
single-line method doc strings.

This patch adds some description of the RESTful parameters.

For methods that take no parameters (eg, get_all) it simply
converts the doc strings to multi-line, even though this does not
adhere to PEP257. This is a work-around for a bug.
  https://github.com/dreamhost/sphinxcontrib-pecanwsme/issues/8

Change-Id: I0fde3314bf2d5c3e109ec85626d3e509ffd53c7c
Merge "Fix auto-generated REST API formatting"