Takeshi KOMIYA comments

Results 181 comments of


                                            Takeshi KOMIYA

autodoc-skip-member "what" value is wrong, and "name" is not fully qualified but doc says it is

+0 for changing the behavior. But we have to consider how to keep the compatibility of this behavior because this bug was implemented as its beginning.

.. include:: directive shouldn't care about filename extension

Yes. As you quoted, Sphinx processes all `.rst` files under the source directory. So the warnings are correct to me. What do you expect?

.. include:: directive shouldn't care about filename extension

At present, Sphinx scans the target documents from the source directory by file extensions. After that, it reads them all. To prevent warnings (or skip processing), we need to know...

Python 3.11: "WARNING: Literal block expected; none found"

It seems the document of the enum subclasses has been changed since 3.11. And it's invalid. ``` $ python3.10 Python 3.10.3 (main, Apr 6 2022, 11:26:01) [Clang 11.0.3 (clang-1103.0.32.62)] on...

display the line numbers using sphinx.ext.viewcode?

PR is welcome. Please use `add_config_value()` to add a new configuration variable.

Fix/agogo

@mgeier Could you check this please?

autodoc failed to import module even though module is in path

It seems both `service1` and `service2` have `routines` package. Is it possible to import it from python interpreter? Could you check it before using Sphinx?

autodoc failed to import module even though module is in path

Could you share an example? I'd like to reproduce the error on my local.

Allow a CLI that does not handle Exceptions.

Thank you for your proposal. I understand your concern and agree with you. +1 for improving Sphinx to debug it on IDE. But I don't still understand your proposal. Could...

Modernising the `basic` theme

I don't have knowledge of modern HTML. So I'm not sure which option is better. But +1 for improvement if somebody will help us. >At some point we should also...