Skip to content

Commit 3f4089d

Browse files
topper-123jorisvandenbossche
authored andcommitted
Removed references to v0.17 in docs and doc strings. (#17923)
Also removes a reference to 0.13.
1 parent 4af9a8b commit 3f4089d

23 files changed

+17
-196
lines changed

doc/source/basics.rst

+1-8
Original file line numberDiff line numberDiff line change
@@ -1738,11 +1738,6 @@ description.
17381738
Sorting
17391739
-------
17401740

1741-
.. warning::
1742-
1743-
The sorting API is substantially changed in 0.17.0, see :ref:`here <whatsnew_0170.api_breaking.sorting>` for these changes.
1744-
In particular, all sorting methods now return a new object by default, and **DO NOT** operate in-place (except by passing ``inplace=True``).
1745-
17461741
There are two obvious kinds of sorting that you may be interested in: sorting
17471742
by label and sorting by actual values.
17481743

@@ -1829,8 +1824,6 @@ faster than sorting the entire Series and calling ``head(n)`` on the result.
18291824
s.nsmallest(3)
18301825
s.nlargest(3)
18311826
1832-
.. versionadded:: 0.17.0
1833-
18341827
``DataFrame`` also has the ``nlargest`` and ``nsmallest`` methods.
18351828

18361829
.. ipython:: python
@@ -1881,7 +1874,7 @@ dtypes
18811874
------
18821875

18831876
The main types stored in pandas objects are ``float``, ``int``, ``bool``,
1884-
``datetime64[ns]`` and ``datetime64[ns, tz]`` (in >= 0.17.0), ``timedelta[ns]``,
1877+
``datetime64[ns]`` and ``datetime64[ns, tz]``, ``timedelta[ns]``,
18851878
``category`` and ``object``. In addition these dtypes have item sizes, e.g.
18861879
``int64`` and ``int32``. See :ref:`Series with TZ <timeseries.timezone_series>`
18871880
for more detail on ``datetime64[ns, tz]`` dtypes.

doc/source/categorical.rst

-2
Original file line numberDiff line numberDiff line change
@@ -632,8 +632,6 @@ To get a single value `Series` of type ``category`` pass in a list with a single
632632
String and datetime accessors
633633
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
634634

635-
.. versionadded:: 0.17.1
636-
637635
The accessors ``.dt`` and ``.str`` will work if the ``s.cat.categories`` are of an appropriate
638636
type:
639637

doc/source/computation.rst

-2
Original file line numberDiff line numberDiff line change
@@ -206,8 +206,6 @@ Window Functions
206206
functions and are now deprecated. These are replaced by using the :class:`~pandas.core.window.Rolling`, :class:`~pandas.core.window.Expanding` and :class:`~pandas.core.window.EWM`. objects and a corresponding method call.
207207

208208
The deprecation warning will show the new syntax, see an example :ref:`here <whatsnew_0180.window_deprecations>`
209-
You can view the previous documentation
210-
`here <http://pandas.pydata.org/pandas-docs/version/0.17.1/computation.html#moving-rolling-statistics-moments>`__
211209

212210
For working with data, a number of windows functions are provided for
213211
computing common *window* or *rolling* statistics. Among these are count, sum,

doc/source/contributing.rst

+4-4
Original file line numberDiff line numberDiff line change
@@ -877,12 +877,12 @@ directive is used. The sphinx syntax for that is:
877877
878878
.. code-block:: rst
879879
880-
.. versionadded:: 0.17.0
880+
.. versionadded:: 0.21.0
881881
882-
This will put the text *New in version 0.17.0* wherever you put the sphinx
882+
This will put the text *New in version 0.21.0* wherever you put the sphinx
883883
directive. This should also be put in the docstring when adding a new function
884-
or method (`example <https://github.com/pandas-dev/pandas/blob/v0.16.2/pandas/core/generic.py#L1959>`__)
885-
or a new keyword argument (`example <https://github.com/pandas-dev/pandas/blob/v0.16.2/pandas/core/frame.py#L1171>`__).
884+
or method (`example <https://github.com/pandas-dev/pandas/blob/v0.20.2/pandas/core/frame.py#L1495>`__)
885+
or a new keyword argument (`example <https://github.com/pandas-dev/pandas/blob/v0.20.2/pandas/core/generic.py#L568>`__).
886886
887887
Contributing your changes to *pandas*
888888
=====================================

doc/source/ecosystem.rst

+4-1
Original file line numberDiff line numberDiff line change
@@ -146,7 +146,10 @@ API
146146

147147
`pandas-datareader <https://github.com/pydata/pandas-datareader>`__
148148
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
149-
``pandas-datareader`` is a remote data access library for pandas. ``pandas.io`` from pandas < 0.17.0 is now refactored/split-off to and importable from ``pandas_datareader`` (PyPI:``pandas-datareader``). Many/most of the supported APIs have at least a documentation paragraph in the `pandas-datareader docs <https://pandas-datareader.readthedocs.io/en/latest/>`_:
149+
``pandas-datareader`` is a remote data access library for pandas (PyPI:``pandas-datareader``).
150+
It is based on functionality that was located in ``pandas.io.data`` and ``pandas.io.wb`` but was
151+
split off in v0.19.
152+
See more in the `pandas-datareader docs <https://pandas-datareader.readthedocs.io/en/latest/>`_:
150153

151154
The following data feeds are available:
152155

doc/source/gotchas.rst

-2
Original file line numberDiff line numberDiff line change
@@ -47,8 +47,6 @@ The ``+`` symbol indicates that the true memory usage could be higher, because
4747
pandas does not count the memory used by values in columns with
4848
``dtype=object``.
4949

50-
.. versionadded:: 0.17.1
51-
5250
Passing ``memory_usage='deep'`` will enable a more accurate memory usage report,
5351
that accounts for the full usage of the contained objects. This is optional
5452
as it can be expensive to do this deeper introspection.

doc/source/indexing.rst

-2
Original file line numberDiff line numberDiff line change
@@ -1632,8 +1632,6 @@ Missing values
16321632

16331633
.. _indexing.missing:
16341634

1635-
.. versionadded:: 0.17.1
1636-
16371635
.. important::
16381636

16391637
Even though ``Index`` can hold missing values (``NaN``), it should be avoided

doc/source/io.rst

+3-47
Original file line numberDiff line numberDiff line change
@@ -2689,11 +2689,6 @@ of sheet names can simply be passed to ``read_excel`` with no loss in performanc
26892689
# equivalent using the read_excel function
26902690
data = read_excel('path_to_file.xls', ['Sheet1', 'Sheet2'], index_col=None, na_values=['NA'])
26912691
2692-
.. versionadded:: 0.17
2693-
2694-
``read_excel`` can take an ``ExcelFile`` object as input
2695-
2696-
26972692
.. _io.excel.specifying_sheets:
26982693

26992694
Specifying Sheets
@@ -2754,8 +2749,6 @@ respectively.
27542749
Reading a ``MultiIndex``
27552750
++++++++++++++++++++++++
27562751

2757-
.. versionadded:: 0.17
2758-
27592752
``read_excel`` can read a ``MultiIndex`` index, by passing a list of columns to ``index_col``
27602753
and a ``MultiIndex`` column by passing a list of rows to ``header``. If either the ``index``
27612754
or ``columns`` have serialized level names those will be read in as well by specifying
@@ -2928,14 +2921,8 @@ one can pass an :class:`~pandas.io.excel.ExcelWriter`.
29282921
Writing Excel Files to Memory
29292922
+++++++++++++++++++++++++++++
29302923

2931-
.. versionadded:: 0.17
2932-
29332924
Pandas supports writing Excel files to buffer-like objects such as ``StringIO`` or
2934-
``BytesIO`` using :class:`~pandas.io.excel.ExcelWriter`.
2935-
2936-
.. versionadded:: 0.17
2937-
2938-
Added support for Openpyxl >= 2.2
2925+
``BytesIO`` using :class:`~pandas.io.excel.ExcelWriter`. Pandas also supports Openpyxl >= 2.2.
29392926

29402927
.. code-block:: python
29412928
@@ -3191,25 +3178,6 @@ both on the writing (serialization), and reading (deserialization).
31913178
optimizations in the io of the ``msgpack`` data. Since this is marked
31923179
as an EXPERIMENTAL LIBRARY, the storage format may not be stable until a future release.
31933180

3194-
As a result of writing format changes and other issues:
3195-
3196-
+----------------------+------------------------+
3197-
| Packed with | Can be unpacked with |
3198-
+======================+========================+
3199-
| pre-0.17 / Python 2 | any |
3200-
+----------------------+------------------------+
3201-
| pre-0.17 / Python 3 | any |
3202-
+----------------------+------------------------+
3203-
| 0.17 / Python 2 | - 0.17 / Python 2 |
3204-
| | - >=0.18 / any Python |
3205-
+----------------------+------------------------+
3206-
| 0.17 / Python 3 | >=0.18 / any Python |
3207-
+----------------------+------------------------+
3208-
| 0.18 | >= 0.18 |
3209-
+----------------------+------------------------+
3210-
3211-
Reading (files packed by older versions) is backward-compatibile, except for files packed with 0.17 in Python 2, in which case only they can only be unpacked in Python 2.
3212-
32133181
.. ipython:: python
32143182
32153183
df = pd.DataFrame(np.random.rand(5,2),columns=list('AB'))
@@ -3287,10 +3255,6 @@ for some advanced strategies
32873255
If you see a subset of results being returned, upgrade to ``PyTables`` >= 3.2.
32883256
Stores created previously will need to be rewritten using the updated version.
32893257

3290-
.. warning::
3291-
3292-
As of version 0.17.0, ``HDFStore`` will not drop rows that have all missing values by default. Previously, if all values (except the index) were missing, ``HDFStore`` would not write those rows to disk.
3293-
32943258
.. ipython:: python
32953259
:suppress:
32963260
:okexcept:
@@ -3388,7 +3352,7 @@ similar to how ``read_csv`` and ``to_csv`` work.
33883352
os.remove('store_tl.h5')
33893353
33903354
3391-
As of version 0.17.0, HDFStore will no longer drop rows that are all missing by default. This behavior can be enabled by setting ``dropna=True``.
3355+
HDFStore will by default not drop rows that are all missing. This behavior can be changed by setting ``dropna=True``.
33923356

33933357
.. ipython:: python
33943358
:suppress:
@@ -3632,12 +3596,6 @@ Querying
36323596
Querying a Table
36333597
++++++++++++++++
36343598

3635-
.. warning::
3636-
3637-
This query capabilities have changed substantially starting in ``0.13.0``.
3638-
Queries from prior version are accepted (with a ``DeprecationWarning``) printed
3639-
if its not string-like.
3640-
36413599
``select`` and ``delete`` operations have an optional criterion that can
36423600
be specified to select/delete only a subset of the data. This allows one
36433601
to have a very large on-disk table and retrieve only a portion of the
@@ -5098,10 +5056,8 @@ whether imported ``Categorical`` variables are ordered.
50985056
SAS Formats
50995057
-----------
51005058

5101-
.. versionadded:: 0.17.0
5102-
51035059
The top-level function :func:`read_sas` can read (but not write) SAS
5104-
`xport` (.XPT) and `SAS7BDAT` (.sas7bdat) format files were added in *v0.18.0*.
5060+
`xport` (.XPT) and (since *v0.18.0*) `SAS7BDAT` (.sas7bdat) format files.
51055061

51065062
SAS files only contain two value types: ASCII text and floating point
51075063
values (usually 8 bytes but sometimes truncated). For xport files,

doc/source/merging.rst

+1-5
Original file line numberDiff line numberDiff line change
@@ -550,8 +550,6 @@ standard database join operations between DataFrame objects:
550550
merge key only appears in ``'right'`` DataFrame, and ``both`` if the
551551
observation's merge key is found in both.
552552

553-
.. versionadded:: 0.17.0
554-
555553
- ``validate`` : string, default None.
556554
If specified, checks if merge is of specified type.
557555

@@ -766,9 +764,7 @@ If the user is aware of the duplicates in the right `DataFrame` but wants to ens
766764
The merge indicator
767765
~~~~~~~~~~~~~~~~~~~
768766

769-
.. versionadded:: 0.17.0
770-
771-
``merge`` now accepts the argument ``indicator``. If ``True``, a Categorical-type column called ``_merge`` will be added to the output object that takes on values:
767+
``merge`` accepts the argument ``indicator``. If ``True``, a Categorical-type column called ``_merge`` will be added to the output object that takes on values:
772768

773769
=================================== ================
774770
Observation Origin ``_merge`` value

doc/source/missing_data.rst

-4
Original file line numberDiff line numberDiff line change
@@ -352,10 +352,6 @@ examined :ref:`in the API <api.dataframe.missing>`.
352352
Interpolation
353353
~~~~~~~~~~~~~
354354

355-
.. versionadded:: 0.17.0
356-
357-
The ``limit_direction`` keyword argument was added.
358-
359355
Both Series and DataFrame objects have an ``interpolate`` method that, by default,
360356
performs linear interpolation at missing datapoints.
361357

doc/source/remote_data.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Remote Data Access
1111
DataReader
1212
----------
1313

14-
The sub-package ``pandas.io.data`` was deprecated in v.0.17 and removed in
14+
The sub-package ``pandas.io.data`` was removed in
1515
`v.0.19 <http://pandas-docs.github.io/pandas-docs-travis/whatsnew.html#v0-19-0-october-2-2016>`__.
1616
Instead there has been created a separately installable
1717
`pandas-datareader package <https://github.com/pydata/pandas-datareader>`__.

doc/source/timeseries.rst

+1-8
Original file line numberDiff line numberDiff line change
@@ -229,12 +229,7 @@ You can pass only the columns that you need to assemble.
229229
Invalid Data
230230
~~~~~~~~~~~~
231231

232-
.. note::
233-
234-
In version 0.17.0, the default for ``to_datetime`` is now ``errors='raise'``, rather than ``errors='ignore'``. This means
235-
that invalid parsing will raise rather that return the original input as in previous versions.
236-
237-
The default behavior, ``errors='raise'``, is to raise when unparseable:
232+
The default behavior, ``errors='raise'``, is to raise when unparseable:
238233

239234
.. code-block:: ipython
240235
@@ -2230,8 +2225,6 @@ constructor as well as ``tz_localize``.
22302225
TZ Aware Dtypes
22312226
~~~~~~~~~~~~~~~
22322227

2233-
.. versionadded:: 0.17.0
2234-
22352228
``Series/DatetimeIndex`` with a timezone **naive** value are represented with a dtype of ``datetime64[ns]``.
22362229

22372230
.. ipython:: python

doc/source/visualization.rst

-2
Original file line numberDiff line numberDiff line change
@@ -129,8 +129,6 @@ For example, a bar plot can be created the following way:
129129
@savefig bar_plot_ex.png
130130
df.iloc[5].plot(kind='bar');
131131
132-
.. versionadded:: 0.17.0
133-
134132
You can also create these other plots using the methods ``DataFrame.plot.<kind>`` instead of providing the ``kind`` keyword argument. This makes it easier to discover plot methods and the specific arguments they use:
135133

136134
.. ipython::

pandas/core/frame.py

-10
Original file line numberDiff line numberDiff line change
@@ -182,8 +182,6 @@
182182
"right_only" for observations whose merge key only appears in 'right'
183183
DataFrame, and "both" if the observation's merge key is found in both.
184184
185-
.. versionadded:: 0.17.0
186-
187185
validate : string, default None
188186
If specified, checks if merge is of specified type.
189187
@@ -916,8 +914,6 @@ def to_dict(self, orient='dict', into=dict):
916914
[{column -> value}, ... , {column -> value}]
917915
- index : dict like {index -> {column -> value}}
918916
919-
.. versionadded:: 0.17.0
920-
921917
Abbreviations are allowed. `s` indicates `series` and `sp`
922918
indicates `split`.
923919
@@ -3743,8 +3739,6 @@ def nlargest(self, n, columns, keep='first'):
37433739
"""Get the rows of a DataFrame sorted by the `n` largest
37443740
values of `columns`.
37453741
3746-
.. versionadded:: 0.17.0
3747-
37483742
Parameters
37493743
----------
37503744
n : int
@@ -3780,8 +3774,6 @@ def nsmallest(self, n, columns, keep='first'):
37803774
"""Get the rows of a DataFrame sorted by the `n` smallest
37813775
values of `columns`.
37823776
3783-
.. versionadded:: 0.17.0
3784-
37853777
Parameters
37863778
----------
37873779
n : int
@@ -5350,8 +5342,6 @@ def round(self, decimals=0, *args, **kwargs):
53505342
"""
53515343
Round a DataFrame to a variable number of decimal places.
53525344
5353-
.. versionadded:: 0.17.0
5354-
53555345
Parameters
53565346
----------
53575347
decimals : int, dict, Series

pandas/core/generic.py

-10
Original file line numberDiff line numberDiff line change
@@ -2415,7 +2415,6 @@ def reindex_like(self, other, method=None, copy=True, limit=None,
24152415
Maximum distance between labels of the other object and this
24162416
object for inexact matches. Can be list-like.
24172417
2418-
.. versionadded:: 0.17.0
24192418
.. versionadded:: 0.21.0 (list-like tolerance)
24202419
24212420
Notes
@@ -2622,8 +2621,6 @@ def add_suffix(self, suffix):
26222621
_shared_docs['sort_values'] = """
26232622
Sort by the values along either axis
26242623
2625-
.. versionadded:: 0.17.0
2626-
26272624
Parameters
26282625
----------%(optional_by)s
26292626
axis : %(axes_single_arg)s, default 0
@@ -2810,7 +2807,6 @@ def sort_index(self, axis=0, level=None, ascending=True, inplace=False,
28102807
the same size as the index and its dtype must exactly match the
28112808
index's type.
28122809
2813-
.. versionadded:: 0.17.0
28142810
.. versionadded:: 0.21.0 (list-like tolerance)
28152811
28162812
Examples
@@ -3077,7 +3073,6 @@ def _reindex_multi(self, axes, copy, fill_value):
30773073
the same size as the index and its dtype must exactly match the
30783074
index's type.
30793075
3080-
.. versionadded:: 0.17.0
30813076
.. versionadded:: 0.21.0 (list-like tolerance)
30823077
30833078
Examples
@@ -4658,9 +4653,6 @@ def replace(self, to_replace=None, value=None, inplace=False, limit=None,
46584653
limit_direction : {'forward', 'backward', 'both'}, default 'forward'
46594654
If limit is specified, consecutive NaNs will be filled in this
46604655
direction.
4661-
4662-
.. versionadded:: 0.17.0
4663-
46644656
inplace : bool, default False
46654657
Update the NDFrame in place if possible.
46664658
downcast : optional, 'infer' or None, defaults to None
@@ -5667,8 +5659,6 @@ def ranker(data):
56675659
Broadcast values along this axis, if aligning two objects of
56685660
different dimensions
56695661
5670-
.. versionadded:: 0.17.0
5671-
56725662
Returns
56735663
-------
56745664
(left, right) : (%(klass)s, type of other)

pandas/core/indexes/base.py

-2
Original file line numberDiff line numberDiff line change
@@ -2490,7 +2490,6 @@ def _get_unique_index(self, dropna=False):
24902490
includes list, tuple, array, Series, and must be the same size as
24912491
the index and its dtype must exactly match the index's type.
24922492
2493-
.. versionadded:: 0.17.0
24942493
.. versionadded:: 0.21.0 (list-like tolerance)
24952494
24962495
Returns
@@ -2640,7 +2639,6 @@ def _get_level_values(self, level):
26402639
the same size as the index and its dtype must exactly match the
26412640
index's type.
26422641
2643-
.. versionadded:: 0.17.0
26442642
.. versionadded:: 0.21.0 (list-like tolerance)
26452643
26462644
Examples

pandas/core/indexes/datetimelike.py

-2
Original file line numberDiff line numberDiff line change
@@ -47,8 +47,6 @@ def strftime(self, date_format):
4747
supports the same string format as the python standard library. Details
4848
of the string format can be found in `python string format doc <{0}>`__
4949
50-
.. versionadded:: 0.17.0
51-
5250
Parameters
5351
----------
5452
date_format : str

0 commit comments

Comments
 (0)