При написании строки документации для любого члена python я обнаружил, что Sphinx обрезает строку «краткого резюме» при первой увиденной точке. Это раздражает, когда я хочу использовать такие вещи, как 'eg' или 'ie' et c.
Пример:
class Foo:
"""Short summary e.g. this bit gets left off.
Extended summary...
"""
Будет произведено:
Foo: 'Short summary e.g.'
Кто-нибудь знает, как это исправить? Примечание. Я использую Sphinx 1.6.6 и не уверен, что эта проблема сохранится в других версиях.