Merge pull request numpy#5217 from jnothman/note-issue-1866

charris · charris · commit e73ee5dbab7d · 2014-11-29T10:47:17.000-05:00
DOC note the effect of numpy#1866 in byteorder discussion
diff --git a/numpy/doc/byteswapping.py b/numpy/doc/byteswapping.py
@@ -61,6 +61,15 @@
 big-endian (data endianness) and we've set the dtype to match (the dtype
 is also big-endian).  However, sometimes you need to flip these around.
 
+.. warning::
+
+    Scalars currently do not include byte order information, so extracting
+    a scalar from an array will return an integer in native byte order.
+    Hence:
+
+    >>> big_end_arr[0].dtype.byteorder == little_end_u4[0].dtype.byteorder
+    True
+
 Changing byte ordering
 ======================
 
