Hi everybody,
I want to propose dropping the difference between staticmethod and
classmethod in sphinx.
Currently you can attribute a method both as static and as classmethod.
However except in one situation classmethod and staticmethod work
exactly the same from a caller's point of view.
I would go as far as saying that if a method is decorated using
staticmethod or classmethod is an implementation detail and something a
caller should not rely on.
Right now it's quite confusing in documentation (especially on
documentation created using autodoc) that some methods appear as
"static" and others as "classmethod".
So I propose two solutions:
a) either get rid of classmethod entirely or
b) let autodoc generate "static" for class methods too,
not only for static methods.
What do you think about that?
Regards,
Armin
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---
