python - sphinx-apidoc は、生成されたファイルにサブパッケージを含めません

Question

私のディレクトリは次のとおりです（適切な__init__.pyファイルはここにリストされていません）：

root
    package1/
        subpackage1/
          submodule1.py
        module1.py

    package2/
        module2.py

    docs/

実行sphinx-apidoc . --full -o docs -H 'MyProject' -A 'MyName' -V '1.0'すると、必要なほとんどすべてが得られます。

• index.rst
• package1.rst
• package1.subpackage1.rst
• package2.rst

indexリストしますが、リストpackage1しません。package2 package1package1.subpackage1

package1.rst大規模なプロジェクトですべてのサブパッケージを手動でリストするのはスケーラブルではないため、手動で編集したくありません。