[issue31795] Slicings documentation doesn't mention Ellipsis

2017-10-16 Thread Raymond Hettinger
Raymond Hettinger added the comment: > Can we add an example of its usage in Numpy to the docs? I don't think we should. In CPython, the ellipsis has no interesting semantics. It is something that third-party modules can use however they wish. It doesn't make sense for CPython docs to cov

[issue31795] Slicings documentation doesn't mention Ellipsis

2017-10-15 Thread Nitish
Nitish added the comment: The problem is that while documentation for other objects like Null object, NotImplemented object make it clear what they are used for, documentation for Ellipsis object only says that it's used in slicings and the slicings documentation doesn't cover Ellipsis. Can

[issue31795] Slicings documentation doesn't mention Ellipsis

2017-10-15 Thread Raymond Hettinger
Raymond Hettinger added the comment: In regular Python, the ellipsis isn't used for slicing. It does have special meaning for numpy. So, I think the docs may be correct as is. -- nosy: +rhettinger ___ Python tracker

[issue31795] Slicings documentation doesn't mention Ellipsis

2017-10-15 Thread Nitish
New submission from Nitish : Ellipsis object documentation[1] specifies that Ellipsis is mainly used by Slicings. But Slicing's documentation[2] doesn't mention anything about Ellipsis. Consequently - it is not immediately clear from Ellipsis documentation what it's used for. [1] https://doc