[issue10893] The docs mark staticmethod as a function

Georg Brandl added the comment: Fully agreed. -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.p

[issue10893] The docs mark staticmethod as a function

Raymond Hettinger added the comment: That's just the way we do our markup. Sorry, but this is a total non-issue. You're trying to create finer distinctions than the markup needs to support. Besides, the distinction between types, objects, callables, functions, instances, descriptors and whatnot

[issue10893] The docs mark staticmethod as a function

Éric Araujo added the comment: I don’t have enough experience to make a judgment call here. Raymond or Georg, can you? -- nosy: +georg.brandl versions: +Python 2.7, Python 3.1, Python 3.2 ___ Python tracker

[issue10893] The docs mark staticmethod as a function

Ram Rachum added the comment: So if int is officially a class, why not start doing :class:`int` instead of :func:`int`? "they’re marked up as functions, so you should treat them as functions." Here, I've treated staticmethod as a function: >>> assert isinstance(staticmethod, types.Functi

[issue10893] The docs mark staticmethod as a function

Éric Araujo added the comment: Okay, scratch the comment about int, it’s not been accurate for quite a number of years. Going back to staticmethod, my point still applies: Follow what the docs say. staticmethod is a type in CPython probably due to the way descriptors work; contextlib.closin

[issue10893] The docs mark staticmethod as a function

Ram Rachum added the comment: I'm really confused by your comment. "int being a function is really a CPython implementation detail" I don't understand this. I should be able to do isinstance(x, int) in all implementations of Python, no? So `int` must be a class across all Python implementati

[issue10893] The docs mark staticmethod as a function

Éric Araujo added the comment: staticmethod being a type or int being a function is really a CPython implementation detail. If the docs say something is a class, it behaves as a class, you can subclass it and everything, and the other VMs implement it as a class, why would you want to consid

[issue10893] The docs mark staticmethod as a function

Ram Rachum added the comment: But why? What's the reason for that? Why mislabel a type as a function? -- ___ Python tracker ___ ___ P

[issue10893] The docs mark staticmethod as a function

Changes by Raymond Hettinger : -- resolution: -> invalid status: open -> closed ___ Python tracker ___ ___ Python-bugs-list mailing l

[issue10893] The docs mark staticmethod as a function

SilentGhost added the comment: So, is int, str, bool and enumerate. And many others. The preface on functions page (http://docs.python.org/dev/library/functions.html) says: "The Python interpreter has a number of functions and types built into it that are always available." I would think it

[issue10893] The docs mark staticmethod as a function

New submission from Ram Rachum : The Python documentation uses :func:`staticmethod` to describe staticmethod, while staticmethod is a type. I want to link to the Python documentation from my project's documentation using Intersphinx, and I wouldn't want to mislead my users by marking static m