[issue10893] The docs mark staticmethod as a function

2011-01-13 Thread Ram Rachum
Ram Rachum cool...@cool-rr.com added the comment: But why? What's the reason for that? Why mislabel a type as a function? -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10893 ___

[issue10893] The docs mark staticmethod as a function

2011-01-13 Thread Éric Araujo
Éric Araujo mer...@netwok.org 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

[issue10893] The docs mark staticmethod as a function

2011-01-13 Thread Ram Rachum
Ram Rachum cool...@cool-rr.com 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

[issue10893] The docs mark staticmethod as a function

2011-01-13 Thread Éric Araujo
Éric Araujo mer...@netwok.org 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;

[issue10893] The docs mark staticmethod as a function

2011-01-13 Thread Ram Rachum
Ram Rachum cool...@cool-rr.com 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

[issue10893] The docs mark staticmethod as a function

2011-01-13 Thread Éric Araujo
Éric Araujo mer...@netwok.org 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 rep...@bugs.python.org

[issue10893] The docs mark staticmethod as a function

2011-01-13 Thread Raymond Hettinger
Raymond Hettinger rhettin...@users.sourceforge.net 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,

[issue10893] The docs mark staticmethod as a function

2011-01-13 Thread Georg Brandl
Georg Brandl ge...@python.org added the comment: Fully agreed. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10893 ___ ___ Python-bugs-list

[issue10893] The docs mark staticmethod as a function

2011-01-12 Thread Ram Rachum
New submission from Ram Rachum cool...@cool-rr.com: 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

[issue10893] The docs mark staticmethod as a function

2011-01-12 Thread SilentGhost
SilentGhost ghost@gmail.com 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.

[issue10893] The docs mark staticmethod as a function

2011-01-12 Thread Raymond Hettinger
Changes by Raymond Hettinger rhettin...@users.sourceforge.net: -- resolution: - invalid status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10893 ___