Doxygen が完全に解析する Python スクリプトの先頭に docstring があります。ただし、(スクリプトを実行可能にするために) ファイルの先頭に追加する#!/usr/bin/env python
と、docstring 全体が Doxygen によって認識されません。
では、どうすれば Doxygen にこの最初の行を無視させることができるでしょうか?
動作する docstring の例:
"""@package HelloWorld
This is a docstring and it's recognized by doxygen."""
動作しない docstring の例:
#!/usr/bin/env python
"""@package HelloWorld
This is a docstring and it's not recognized by doxygen because of the first line."""
ありがとう!