Синтаксис Doxygen в Python

Question

Может кто-нибудь помочь мне разобраться, как правильно комментировать код Python, чтобы разобрать по doxygen?

Каким-то образом теги игнорируются.Вывод (HTML) показывает теги:

@brief Creates a new Hello object.
This Hello Object is beeing used to ...

@param name The name of the user.

---

Оба варианта, которые я пробовал, не работают:

class Hello:
    """@brief short description...

    longer description
    """
    def __init__(self, name):
    """@brief Creates a new Hello object.

    This Hello Object is beeing used to ...

    @param name The name of the user.
    """
        self.name = name

---

class Hello:
    """\brief short description...

    longer description
    """
    def __init__(self, name):
    """\brief Creates a new Hello object.

    This Hello Object is beeing used to ...

    \param name The name of the user.
    """
        self.name = name

Answer 1

Doxygen также имеет недокументированную функцию (или ошибку): он анализирует синтаксис Doxygen в строке документации, если вы начинаете строку документации с восклицательного знака:

class Hello: 
    def __init__(self, name):
    """!@brief Creates a new Hello object.

    This Hello Object is being used to...

    @param name The name of the user.
    """
    self.name = name
        dosomething(12)

    def dosomething(x):         
        dosomethingelse

Обратите внимание, что в документации для Python вам нужно использовать @ вместо\ для запуска команд Doxygen (обратная косая черта работает как escape-символ в строке документации).

Answer 2

Чтобы doxygen распознал специальные команды в комментариях Python, вы должны использовать следующую форму комментария:

class Hello: 
    ## \brief Short description.
    # Longer description. 
    # \param self
    # \param name
    def __init__(self, name):         
        dosomething(12)

    def dosomething(x):         
        dosomethingelse

См. http://www.doxygen.nl/manual/docblocks.html#pythonblocks