[1.6.x] Updated advice on six.moves.range/xrange; refs #23812.

timgraham · timgraham · commit 89f9bf61bbbf · 2014-12-13T13:42:51.000-05:00
Backport of bc88ec5 from master
diff --git a/docs/topics/python3.txt b/docs/topics/python3.txt
@@ -359,7 +359,10 @@ The ``long`` type no longer exists in Python 3. ``1L`` is a syntax error. Use
 ``xrange``
 ~~~~~~~~~~
 
-Import ``six.moves.xrange`` wherever you use ``xrange``.
+If you use ``xrange`` on Python 2, import ``six.moves.range`` and use that
+instead. You can also import ``six.moves.xrange`` (it's equivalent to
+``six.moves.range``) but the first technique allows you to simply drop the
+import when dropping support for Python 2.
 
 Moved modules
 ~~~~~~~~~~~~~
