DOC: warning about using numexpr > 2.1 as it has a backward incompatible change

     that affects PyTables < 3.0

Author: jreback

README.md

@@ -96,6 +96,8 @@ pip install pandas
 - [numexpr](http://code.google.com/p/numexpr/)
    - Needed to accelerate some expression evaluation operations
    - Required by PyTables
+   - numexpr version <= 2.1 is recommended as the current version (2.2.1) has a backward
+     incompatible change with PyTables < 3.0
 - [bottleneck](http://berkeleyanalytics.com/bottleneck)
    - Needed to accelerate certain numerical operations
 

doc/source/install.rst

@@ -76,6 +76,12 @@ Recommended Dependencies
 
   * `numexpr <http://code.google.com/p/numexpr/>`__: for accelerating certain numerical operations.
     ``numexpr`` uses multiple cores as well as smart chunking and caching to achieve large speedups.
+
+    .. warning::
+
+       ``numexpr <= 2.1`` is currently recommended as the current version (2.2.1) has a backward incompatible
+       change with ``PyTables < 3.0.0``
+
   * `bottleneck <http://berkeleyanalytics.com/bottleneck>`__: for accelerating certain types of ``nan``
     evaluations. ``bottleneck`` uses specialized cython routines to achieve large speedups.
 
@@ -116,8 +122,8 @@ Optional Dependencies
 
     * `BeautifulSoup4`_ and `html5lib`_ (Any recent version of `html5lib`_ is
       okay.)
-    * `BeautifulSoup4`_ and `lxml`_ 
-    * `BeautifulSoup4`_ and `html5lib`_ and `lxml`_ 
+    * `BeautifulSoup4`_ and `lxml`_
+    * `BeautifulSoup4`_ and `html5lib`_ and `lxml`_
     * Only `lxml`_, although see :ref:`HTML reading gotchas <html-gotchas>`
       for reasons as to why you should probably **not** take this approach.
 

doc/source/io.rst

@@ -1716,6 +1716,11 @@ for some advanced strategies
    backwards compatible) with all ``PyTables`` >= 2.3. For ``python >= 3.2``,
    ``pandas >= 0.12.0`` is required for compatibility.
 
+.. warning::
+
+   ``numexpr <= 2.1`` is currently recommended as the current version (2.2.1) has a backward incompatible
+   change with ``PyTables < 3.0.0``
+
 .. ipython:: python
    :suppress:
    :okexcept: