Decorators look messy in documentation

[saalaa]

Very long decorators look messy when they contain plenty of arguments. The situation should at least be improved through proper formatting (just like for function declarations) but adding the possibility to to disable them could be needed as well.

For example, consider the following code snippet:

@endpoints.api(name='greetings', version='v1')
class HelloWorldApi(remote.Service):
    @endpoints.method(
        MULTIPLY_METHOD_RESOURCE,
        Greeting,
        path='hellogreeting/{times}',
        http_method='POST',
        name='greetings.multiply'
    )
    def greetings_multiply(self, request):
        return Greeting(message=request.message * request.times)

[saalaa]

Here's a sample of the produced documentation: