這些標簽@ivar @param和python docstring中的@type是什么？

Question

安瓿項目在docstring中使用了一些標簽，就像javadoc一樣。

例如，來自pool.py第86行：

def start(self, ampChild=None):
    """
    Starts the ProcessPool with a given child protocol.

    @param ampChild: a L{ampoule.child.AMPChild} subclass.
    @type ampChild: L{ampoule.child.AMPChild} subclass
    """

什么是這些標簽，哪個工具使用它。

Answer 1

文檔工具的標記，可能是epydoc 。

Answer 2

為了好玩，我會注意到Python標准庫使用的是Sphinx / reStructuredText，其信息字段列表類似。

def start(self, ampChild=None):
    """Starts the ProcessPool with a given child protocol.

    :param ampChild: a :class:`ampoule.child.AMPChild` subclass.
    :type ampChild: :class:`ampoule.child.AMPChild` subclass
    """