Merge remote branch 'y-p/deprec_print'

* y-p/deprec_print:
  CLN: rename "print_config.X" to "print.X"
  DOC: add openpyxl, xlrd/xlwt as optional dependencies to README
  DOC: document change of to_string() to return unicode
  ENH: dynamic docstrings for options API
  CLN: add deprecation warning to set_printoptions, reset_printoptions

Author: wesm

README.rst

@@ -77,6 +77,8 @@ Optional dependencies
      * Needed for parts of :mod:`pandas.stats`
   * `pytz <http://pytz.sourceforge.net/>`__
      * Needed for time zone support with ``DateRange``
+  * `openpyxl <http://packages.python.org/openpyxl/>`__, `xlrd/xlwt <http://www.python-excel.org/>`__
+     * Needed for Excel I/O
 
 Installation from sources
 =========================

doc/source/v0.10.0.txt

@@ -135,13 +135,17 @@ API changes
     - ``reset_option`` - reset one or more options to their default value. Partial names are accepted.
     - ``describe_option`` - print a description of one or more options. When called  with no arguments. print all registered options.
 
-    Note: ``set_printoptions`` is now deprecated (but functioning), the print options now live under "print_config.XYZ". For example:
+    Note: ``set_printoptions``/ ``reset_printoptions``  are now deprecated (but functioning), the print options now live under "print.XYZ". For example:
 
 
     .. ipython:: python
 
        import pandas as pd
-       pd.get_option("print_config.max_rows")
+       pd.get_option("print.max_rows")
+
+
+  - to_string() methods now always return unicode strings  (GH2224_).
+
 
 See the `full release notes
 <https://github.com/pydata/pandas/blob/master/RELEASE.rst>`__ or issue tracker
@@ -151,3 +155,4 @@ on GitHub for a complete list.
 .. _GH1996: https://github.com/pydata/pandas/issues/1996
 .. _GH2316: https://github.com/pydata/pandas/issues/2316
 .. _GH2097: https://github.com/pydata/pandas/issues/2097
+.. _GH2224: https://github.com/pydata/pandas/issues/2224

pandas/core/common.py

@@ -1128,7 +1128,7 @@ def in_qtconsole():
 # 2) If you need to send something to the console, use console_encode().
 #
 #    console_encode() should (hopefully) choose the right encoding for you
-#    based on the encoding set in option "print_config.encoding"
+#    based on the encoding set in option "print.encoding"
 #
 # 3) if you need to write something out to file, use
 #    pprint_thing_encoded(encoding).
@@ -1187,10 +1187,10 @@ def pprint_thing(thing, _nest_lvl=0):
          hasattr(thing,'next'):
         return unicode(thing)
     elif (isinstance(thing, dict) and
-          _nest_lvl < get_option("print_config.pprint_nest_depth")):
+          _nest_lvl < get_option("print.pprint_nest_depth")):
         result = _pprint_dict(thing, _nest_lvl)
     elif _is_sequence(thing) and _nest_lvl < \
-		get_option("print_config.pprint_nest_depth"):
+		get_option("print.pprint_nest_depth"):
         result = _pprint_seq(thing, _nest_lvl)
     else:
         # when used internally in the package, everything
@@ -1222,8 +1222,8 @@ def console_encode(object):
     this is the sanctioned way to prepare something for
     sending *to the console*, it delegates to pprint_thing() to get
     a unicode representation of the object relies on the global encoding
-    set in print_config.encoding. Use this everywhere
+    set in print.encoding. Use this everywhere
     where you output to the console.
     """
     return pprint_thing_encoded(object,
-             get_option("print_config.encoding"))
+             get_option("print.encoding"))