diff --git a/pandas/core/ops.py b/pandas/core/ops.py index 3dcfab868bf17..e14f82906cd06 100644 --- a/pandas/core/ops.py +++ b/pandas/core/ops.py @@ -370,6 +370,33 @@ def _get_op_name(op, special): e NaN 2.0 """ +_sub_example_FRAME = """ +>>> a = pd.DataFrame([2, 1, 1, np.nan], index=['a', 'b', 'c', 'd'], +... columns=['one']) +>>> a + one +a 2.0 +b 1.0 +c 1.0 +d NaN +>>> b = pd.DataFrame(dict(one=[1, np.nan, 1, np.nan], +... two=[3, 2, np.nan, 2]), +... index=['a', 'b', 'd', 'e']) +>>> b + one two +a 1.0 3.0 +b NaN 2.0 +d 1.0 NaN +e NaN 2.0 +>>> a.sub(b, fill_value=0) + one two +a 1.0 -3.0 +b 1.0 -2.0 +c 1.0 NaN +d -1.0 NaN +e NaN -2.0 +""" + _op_descriptions = { # Arithmetic Operators 'add': {'op': '+', @@ -379,7 +406,7 @@ def _get_op_name(op, special): 'sub': {'op': '-', 'desc': 'Subtraction', 'reverse': 'rsub', - 'df_examples': None}, + 'df_examples': _sub_example_FRAME}, 'mul': {'op': '*', 'desc': 'Multiplication', 'reverse': 'rmul',