В выходном HTML-коде не сохраняются разрывы строк, присутствующие в строке документации.
Пример:
Код
Код: Выделить всё
def testMethod(arg1,arg2):
"""
This is a test method
Arguments:
arg1: arg1 description
arg2: arg2 description
Returns:
None
"""
print "I am a test method"
Код: Выделить всё
TestModule.testMethod(arg1, arg2)
This is a test method
Arguments: arg1: arg1 description arg2: arg2 description
Returns: None
Подробнее здесь: https://stackoverflow.com/questions/703 ... ing-sphinx