Improving property to accept abstract methods

Lib/numbers.py

 # Copyright 2007 Google, Inc. All Rights Reserved.
 # Licensed to PSF under a Contributor Agreement.
 
 """Abstract Base Classes (ABCs) for numbers, according to PEP 3141.
 
 TODO: Fill out more detailed documentation on the operators."""
 
 from abc import ABCMeta, abstractmethod
 
 __all__ = ["Number", "Complex", "Real", "Rational", "Integral"]
@@ skipping 289 matching lines @@
     """Integral adds a conversion to int and the bit-string operations."""
 
     __slots__ = ()
 
     @abstractmethod
     def __int__(self):
         """int(self)"""
         raise NotImplementedError
 
     def __index__(self):
-        """someobject[self]"""
+        """Called whenever an index is needed, such as in slicing"""
         return int(self)
 
     @abstractmethod
     def __pow__(self, exponent, modulus=None):
         """self ** exponent % modulus, but maybe faster.
 
         Accept the modulus argument if you want to support the
         3-argument version of pow(). Raise a TypeError if exponent < 0
         or any argument isn't Integral. Otherwise, just implement the
         2-argument version described in Complex.
@@ skipping 64 matching lines @@
     def numerator(self):
         """Integers are their own numerators."""
         return +self
 
     @property
     def denominator(self):
         """Integers have a denominator of 1."""
         return 1
 
 Integral.register(int)