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
___
É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
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
É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;
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
É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
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,
Georg Brandl ge...@python.org added the comment:
Fully agreed.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10893
___
___
Python-bugs-list
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
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.
Changes by Raymond Hettinger rhettin...@users.sourceforge.net:
--
resolution: - invalid
status: open - closed
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10893
___
11 matches
Mail list logo