doc note: for-from loop syntax is discouraged

diff --git a/docs/src/userguide/pyrex_differences.rst b/docs/src/userguide/pyrex_differences.rst
index efad717..21aa16f 100644 (file)
--- a/docs/src/userguide/pyrex_differences.rst
+++ b/docs/src/userguide/pyrex_differences.rst
@@ -127,8 +127,9 @@ yields::
     6
     8
 
-.. note:: see :ref:`automatic-range-conversion`
-       
+.. note:: Usage of this syntax is discouraged as it is redundant with the
+          normal Python :keyword:`for` loop.
+          See :ref:`automatic-range-conversion`.
 
 Boolean int type (e.g. it acts like a c int, but coerces to/from python as a boolean)
 ======================================================================================