Commit a0073825 authored by Fred Drake's avatar Fred Drake

Adjust the way __getslice__() is marked as deprecated; this will also

stand out more.
parent 304faf94
...@@ -1045,7 +1045,7 @@ sequence, the allowable keys should be the integers \var{k} for which ...@@ -1045,7 +1045,7 @@ sequence, the allowable keys should be the integers \var{k} for which
sequence, or slice objects, which define a range of items. (For backwards sequence, or slice objects, which define a range of items. (For backwards
compatibility, the method \method{__getslice__()} (see below) can also be compatibility, the method \method{__getslice__()} (see below) can also be
defined to handle simple, but not extended slices.) It is also recommended defined to handle simple, but not extended slices.) It is also recommended
that mappings provide methods \method{keys()}, \method{values()}, that mappings provide the methods \method{keys()}, \method{values()},
\method{items()}, \method{has_key()}, \method{get()}, \method{clear()}, \method{items()}, \method{has_key()}, \method{get()}, \method{clear()},
\method{copy()}, and \method{update()} behaving similar to those for \method{copy()}, and \method{update()} behaving similar to those for
Python's standard dictionary objects; mutable sequences should provide Python's standard dictionary objects; mutable sequences should provide
...@@ -1132,6 +1132,8 @@ objects. Immutable sequences methods should only define ...@@ -1132,6 +1132,8 @@ objects. Immutable sequences methods should only define
three methods. three methods.
\begin{methoddesc}[sequence object]{__getslice__}{self, i, j} \begin{methoddesc}[sequence object]{__getslice__}{self, i, j}
\deprecated{2.0}{Support slice objects as parameters to the
\method{__getitem__()} method.}
Called to implement evaluation of \code{\var{self}[\var{i}:\var{j}]}. Called to implement evaluation of \code{\var{self}[\var{i}:\var{j}]}.
The returned object should be of the same type as \var{self}. Note The returned object should be of the same type as \var{self}. Note
that missing \var{i} or \var{j} in the slice expression are replaced that missing \var{i} or \var{j} in the slice expression are replaced
...@@ -1142,7 +1144,7 @@ If the instance does not implement the \method{__len__()} method, an ...@@ -1142,7 +1144,7 @@ If the instance does not implement the \method{__len__()} method, an
No guarantee is made that indexes adjusted this way are not still No guarantee is made that indexes adjusted this way are not still
negative. Indexes which are greater than the length of the sequence negative. Indexes which are greater than the length of the sequence
are not modified. are not modified.
This method is deprecated. If no \method{__getslice__()} is found, a slice If no \method{__getslice__()} is found, a slice
object is created instead, and passed to \method{__getitem__()} instead. object is created instead, and passed to \method{__getitem__()} instead.
\end{methoddesc} \end{methoddesc}
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment