DOC: versionadded directions added where needed

Author: jreback

doc/source/api.rst

@@ -488,7 +488,6 @@ These can be accessed like ``Series.dt.<property>``.
    Series.dt.second
    Series.dt.microsecond
    Series.dt.nanosecond
-   Series.dt.second
    Series.dt.week
    Series.dt.weekofyear
    Series.dt.dayofweek
@@ -538,6 +537,7 @@ These can be accessed like ``Series.dt.<property>``.
    :template: autosummary/accessor_method.rst
 
    Series.dt.to_pytimedelta
+   Series.dt.total_seconds
 
 String handling
 ~~~~~~~~~~~~~~~
@@ -1439,6 +1439,7 @@ Time-specific operations
    :toctree: generated/
 
    DatetimeIndex.normalize
+   DatetimeIndex.strftime
    DatetimeIndex.snap
    DatetimeIndex.tz_convert
    DatetimeIndex.tz_localize

doc/source/whatsnew/v0.17.0.txt

@@ -257,7 +257,7 @@ has been changed to make this keyword unnecessary - the change is shown below.
 Other enhancements
 ^^^^^^^^^^^^^^^^^^
 
-- ``pd.read_sql`` and ``to_sql`` can accept database URI as con parameter (:issue:`10214`)
+- ``pd.read_sql`` and ``to_sql`` can accept database URI as ``con`` parameter (:issue:`10214`)
 - Enable ``pd.read_hdf`` to be used without specifying a key when the HDF file contains a single dataset (:issue:`10443`)
 - Enable writing Excel files in :ref:`memory <_io.excel_writing_buffer>` using StringIO/BytesIO (:issue:`7074`)
 - Enable serialization of lists and dicts to strings in ``ExcelWriter`` (:issue:`8188`)
@@ -444,7 +444,7 @@ We have also deprecated and changed similar methods in two Series-like classes,
 Previous                              Replacement
 ==================================    ====================================
 \* ``Index.order()``                  ``Index.sort_values()``
-\* ``Categorical.order()``            ``Categorical.sort_values``
+\* ``Categorical.order()``            ``Categorical.sort_values()``
 ==================================    ====================================
 
 .. _whatsnew_0170.api_breaking.to_datetime:
@@ -817,7 +817,7 @@ Other API Changes
 ^^^^^^^^^^^^^^^^^
 
 - Line and kde plot with ``subplots=True`` now uses default colors, not all black. Specify ``color='k'`` to draw all lines in black (:issue:`9894`)
-- Calling the ``.value_counts`` method on a Series with ``categorical`` dtype now returns a Series with a ``CategoricalIndex`` (:issue:`10704`)
+- Calling the ``.value_counts()`` method on a Series with ``categorical`` dtype now returns a Series with a ``CategoricalIndex`` (:issue:`10704`)
 - Allow passing `kwargs` to the interpolation methods (:issue:`10378`).
 - The metadata properties of subclasses of pandas objects will now be serialized (:issue:`10553`).
 - ``groupby`` using ``Categorical`` follows the same rule as ``Categorical.unique`` described above  (:issue:`10508`)
@@ -848,7 +848,7 @@ Deprecations
   Deprecated Function    Replacement
   =====================  =================================
   ``.irow(i)``           ``.iloc[i]`` or ``.iat[i]``
-  ``.iget(i)``           ``.iloc[i]``
+  ``.iget(i)``           ``.iloc[i]`` or ``.iat[i]``
   ``.iget_value(i)``     ``.iloc[i]`` or ``.iat[i]``
   =====================  =================================
 
@@ -987,7 +987,7 @@ Bug Fixes
 - Bug in ``Series.shift`` and ``DataFrame.shift`` not supporting categorical data (:issue:`9416`)
 - Bug in ``Series.map`` using categorical ``Series`` raises ``AttributeError`` (:issue:`10324`)
 - Bug in ``MultiIndex.get_level_values`` including ``Categorical`` raises ``AttributeError`` (:issue:`10460`)
-- Bug in ``pd.get_dummies`` with `sparse=True` not returning ``SparseDataFrame`` (:issue:`10531`)
+- Bug in ``pd.get_dummies`` with ``sparse=True`` not returning ``SparseDataFrame`` (:issue:`10531`)
 - Bug in ``Index`` subtypes (such as ``PeriodIndex``) not returning their own type for ``.drop`` and ``.insert`` methods (:issue:`10620`)
 - Bug in ``algos.outer_join_indexer`` when ``right`` array is empty (:issue:`10618`)
 

pandas/core/generic.py

@@ -2472,6 +2472,8 @@ def as_blocks(self, copy=True):
         ----------
         copy : boolean, default True
 
+               .. versionadded: 0.16.1
+
         Returns
         -------
         values : a dict of dtype -> Constructor Types
@@ -3275,8 +3277,8 @@ def groupby(self, by=None, axis=0, level=None, as_index=True, sort=True,
             effectively "SQL-style" grouped output
         sort : boolean, default True
             Sort group keys. Get better performance by turning this off.
-            Note this does not influence the order of observations within each group. 
-            groupby preserves the order of rows within each group. 
+            Note this does not influence the order of observations within each group.
+            groupby preserves the order of rows within each group.
         group_keys : boolean, default True
             When calling apply, add group keys to index to identify pieces
         squeeze : boolean, default False

pandas/core/series.py

@@ -824,15 +824,15 @@ def iget(self, i, axis=0):
         DEPRECATED. Use ``.iloc[i]`` or ``.iat[i]`` instead
         """
 
-        warnings.warn("iget(i) is deprecated. Please use .iloc[i]",
+        warnings.warn("iget(i) is deprecated. Please use .iloc[i] or .iat[i]",
                       FutureWarning, stacklevel=2)
         return self._ixs(i)
 
     def irow(self, i, axis=0):
         """
         DEPRECATED. Use ``.iloc[i]`` or ``.iat[i]`` instead
         """
-        warnings.warn("irow(i) is deprecated. Please use .iloc[i] or iat[i]",
+        warnings.warn("irow(i) is deprecated. Please use .iloc[i] or .iat[i]",
                       FutureWarning, stacklevel=2)
         return self._ixs(i)
 

pandas/tseries/base.py

@@ -28,6 +28,8 @@ def strftime(self, date_format):
         of the string format can be found in the `python string format doc
         <https://docs.python.org/2/library/datetime.html#strftime-and-strptime-behavior>`__
 
+        .. versionadded:: 0.17.0
+
         Parameters
         ----------
         date_format : str

pandas/tseries/tdi.py

@@ -400,7 +400,11 @@ def f(x):
         return result
 
     def total_seconds(self):
-        """ Total duration of each element expressed in seconds. """
+        """
+        Total duration of each element expressed in seconds.
+
+        .. versionadded:: 0.17.0
+        """
         return self._maybe_mask_results(1e-9*self.asi8)
 
     def to_pytimedelta(self):

pandas/tseries/tools.py

@@ -199,6 +199,9 @@ def to_datetime(arg, errors='raise', dayfirst=False, yearfirst=False,
         - If both dayfirst and yearfirst are True, yearfirst is preceded (same as dateutil).
         Warning: yearfirst=True is not strict, but will prefer to parse
         with year first (this is a known bug, based on dateutil beahavior).
+
+        .. versionadded: 0.16.1
+
     utc : boolean, default None
         Return UTC DatetimeIndex if True (converting any tz-aware
         datetime.datetime objects as well).