这些标签@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
    """