Что значит такой синтаксис многострочного комментария в python?

Question

[Дмитрий]

def get_nameservers(self, domain):
        """Get Nameservers for the given domain.

        ::
            >>> from dynadotpy.client import Dynadot
            >>> dyn = Dynadot(api_key="<key>")
            >>> result = dyn.get_nameservers(domain="example.com")
            {"result": u"success", "ns0": u"ns1.example.com"...

        :param: String of the domain.
        :return: `dict` of the response from Dynadot's API.
        """

Answer 1

[javedimka]

Это значит, что он написан для Sphinx(или для Docutils, например) - генератора HTML(и не только) документации, сам синтаксис - reStructuredText
Более подробно:
docs.python-guide.org/en/latest/writing/documentation
Конкретные примеры синтаксиса и то как они будут обработаны генератором:
docutils.sourceforge.net/docs/user/rst/quickref.html

Answer 2

[Макс Богачов]

Де-факто это способ написания многострочного комментария.В питоне это три апострофа:

'''
комментарий
'''

либо через двойные кавычки:

"""
коментарий
"""

а к примеру в том же C это бэкслеш+звёздочка:

/*
комментарий
*/

Comments

[Roman K]

Только это не бэкслеш