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.

Reply via email to