Takeshi KOMIYA

Sorry. This is a bug of sphinx-core. We've failed to give default settings to alabaster. Now I'm trying to fix in on https://github.com/sphinx-doc/sphinx/pull/5094 . About `sidebars` option of `theme.conf` was...

How about merging this after CI passed? It's better to merge step by step even if your work still remained. Large and long life PR is difficult to review, merge...

Good point. But -1 for changing interface. We have to give a good syntax to `SPHINX_APIDOC_OPTIONS` to improve it. Just idea, `members,undoc-members,show-inheritance,special-members(__and__, __iand__, __or__, __ior__),exclude-members(__iter__, __call__)` is compatible and a...

Unfortunately, comma is used as a separator for both `SPHINX_APIDOC_OPTIONS`and some autodoc directive options. It means they're conflicted. IMO, it is difficult to make natural style options with original syntax...

I guess this change will cause trouble for Windows users. So it's better not to use `pwd` command as possible. Could you check the advice from jfbu, please?

3.0 will be released in next spring.

No, I don't have time for developing 3.0. At present, I'm doing my best to 2.x release.

>In the future we could then imagine adding a directive option a la :heading: which defaults to +1 and the two other cases could be expressed by :heading: 0 and...

Thank you for proposal. Good idea! I think it would be better to generate javadoc-like documents. So +1 for adding `:toctree:` option to module.rst. https://docs.oracle.com/en/java/javase/13/docs/api/java.logging/java/util/logging/package-summary.html On the other hand, I...

Note: Adding `:toctree:` option to module.rst causes recursive stub-file generation for the given module. We should consider the side effect of the change carefully.