[email protected] ในวันที่ พฤ. 6 ก.พ. 2020 11:58 'Mmanu Chaturvedi' via sphinx-users < [email protected]> เขียนว่า:
> Hi, > > Consider the following problem: > > Suppose we have three methods bound to a class `C` with the following > names: > `__init__`, `a` and `A`. > > Now, in the documentation created by sphinx, we'd have documentation in > order (when `member-order` is `alphabetic`) : > `A`, `__init__` and `a`. > > it seems like it is so because: `sorted(["a", "__init__", "A"]) == ["A", > "__init__", "a"]` > > https://github.com/sphinx-doc/sphinx/blob/master/sphinx/ext/autodoc/__init__.py#L501-L506 > > ------- > > I know that it's not recommended by PEP8, but we have a few methods which > start with a capital letter. ( We're creating python bindings via pybind11). > > This behavior of sphinx, is leading to documentation which looks unsightly > because sometimes `__init__` comes way down after all the methods which > start with a capital letter: > https://www.photobox.co.uk/my/photo/full?photo_id=502682079763 > > I was wondering how could we solve it? > > Thanks, > Mmanu > > > > -- > You received this message because you are subscribed to the Google Groups > "sphinx-users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To view this discussion on the web visit > https://groups.google.com/d/msgid/sphinx-users/abcfbd61-6562-4d65-ae05-a6ff3b5fed1e%40googlegroups.com > <https://groups.google.com/d/msgid/sphinx-users/abcfbd61-6562-4d65-ae05-a6ff3b5fed1e%40googlegroups.com?utm_medium=email&utm_source=footer> > . > -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/CAB0fvB4eaJh0epKhKTJvasNTVwRvhN2T5gBTuEfWWfg%2BA%3DRbEQ%40mail.gmail.com.
