Hi, Is this resolved if we'll add an option for sorting methods by definition order (in source code)? We have an issue to add such option. I'd like to know it helps your case or not.
Thanks, Takeshi KOMIYA 2020年2月6日(木) 13: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. -- 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/CAFmkQAOAs4-57mm0gjfuaVLX3Xg83RM0pbm-5nRSPsREsbjh7w%40mail.gmail.com.
