DOC: DataFrame.to_string/Series.to_string docstrings, GH #732

Author: wesm

RELEASE.rst

@@ -252,6 +252,8 @@ pandas 0.7.0
   - Raise Exception in DateRange when offset with n=0 is passed (GH #683)
   - Fix get/set inconsistency with .ix property and integer location but
     non-integer index (GH #707)
+  - Use right dropna function for SparseSeries. Return dense Series for NA fill
+    value (GH #730)
 
 Thanks
 ------

pandas/core/format.py

@@ -40,7 +40,11 @@
     index_names : bool, optional
         Prints the names of the indexes, default True
     force_unicode : bool, default False
-        Always return a unicode result"""
+        Always return a unicode result
+
+    Returns
+    -------
+    formatted : string (or unicode, depending on data and options)"""
 
 class SeriesFormatter(object):
 

pandas/core/series.py

@@ -595,6 +595,28 @@ def _tidy_repr(self, max_vals=20):
 
     def to_string(self, buf=None, na_rep='NaN', float_format=None,
                   nanRep=None, length=False, name=False):
+        """
+        Render a string representation of the Series
+
+        Parameters
+        ----------
+        buf : StringIO-like, optional
+            buffer to write to
+        na_rep : string, optional
+            string representation of NAN to use, default 'NaN'
+        float_format : one-parameter function, optional
+            formatter function to apply to columns' elements if they are floats
+            default None
+        length : boolean, default False
+            Add the Series length
+        name : boolean, default False
+            Add the Series name (which may be None)
+
+        Returns
+        -------
+        formatted : string (if not buffer passed)
+        """
+
         if nanRep is not None:  # pragma: no cover
             import warnings
             warnings.warn("nanRep is deprecated, use na_rep",