DOC: improved the docstring of pandas.Series.clip_upper improved
(pandas_dev) C:\Users\Jaime\repos\MadrisSprintPandas\pandas\scripts>python validate_docstrings.py pandas.Series.clip_upper

################################################################################
##################### Docstring (pandas.Series.clip_upper) #####################
################################################################################

Return copy of the input with values above given value(s) truncated.

It truncates values above a certain threshold. Threshold can be a single
value or an array, in the latter case it performs the truncation
element-wise.

Parameters
----------
threshold : float or array_like
    Maximum value allowed. All values above threshold will be
    set to this value.
axis : int or string axis name, optional
    Align object with threshold along the given axis.
inplace : boolean, default False
    Whether to perform the operation in place on the data.

See Also
--------
clip : Return copy of input with values below/above thresholds truncated.
clip_lower : Return copy of input with values below given thresholds.

Returns
-------
clipped : same type as input

Examples
--------
>>> s = pd.Series([1,2,3,4,5,6,7])
>>> s
0    1
1    2
2    3
3    4
4    5
5    6
6    7
dtype: int64

>>> s.clip_upper(4)
0    1
1    2
2    3
3    4
4    4
5    4
6    4
dtype: int64

>>> t = [4,8,7,2,5,4,6]
>>> t
[4, 8, 7, 2, 5, 4, 6]

>>> s.clip_upper(t)
0    1
1    2
2    3
3    2
4    5
5    4
6    6
dtype: int64

################################################################################
################################## Validation ##################################
################################################################################

Docstring for "pandas.Series.clip_upper" correct. :)
