diff r 22c8e6d71529 Doc/library/decimal.rst
 a/Doc/library/decimal.rst Sun Oct 28 10:23:08 2012 +0000
+++ b/Doc/library/decimal.rst Sun Oct 28 12:48:51 2012 +0000
@@ 750,12 +750,21 @@
.. method:: remainder_near(other[, context])
 Compute the modulo as either a positive or negative value depending on
 which is closest to zero. For instance, ``Decimal(10).remainder_near(6)``
 returns ``Decimal('2')`` which is closer to zero than ``Decimal('4')``.

 If both are equally close, the one chosen will have the same sign as
 *self*.
+ Return the remainder from dividing *self* by *other*. This differs from
+ ``self % other`` in that the sign of the remainder is chosen so as to
+ minimize its absolute value. More precisely, the return value is
+ ``self  n * other`` where ``n`` is the integer nearest to the exact
+ value of ``self / other``, and if two integers are equally near then the
+ even one is chosen.
+
+ If the result is zero then its sign will be the sign of *self*.
+
+ >>> Decimal(18).remainder_near(Decimal(10))
+ Decimal('2')
+ >>> Decimal(25).remainder_near(Decimal(10))
+ Decimal('5')
+ >>> Decimal(35).remainder_near(Decimal(10))
+ Decimal('5')
.. method:: rotate(other[, context])