Added a description to the examples.

Author: elmq0022

pandas/core/frame.py

@@ -182,10 +182,10 @@
 sort : boolean, default False
     Sort the join keys lexicographically in the result DataFrame. If False,
     the order of the join keys depends on the join type (how keyword).
-suffixes : 2-length sequence (tuple, list, ...)
+suffixes : tuple of (str, str), default ('_x', '_y')
     Suffix to apply to overlapping column names in the left and right
-    side, respectively. If (False, False), overlapping
-    column names raise an error.
+    side, respectively. To raise an exption on overlapping columns use
+    (False, False).
 copy : boolean, default True
     If False, avoid copy if possible.
 indicator : boolean or string, default False
@@ -256,8 +256,11 @@
 4  bar        2  bar        6
 5  baz        3  baz        7
 
+Merge DataFrames A and B. Specify the left and right suffix
+to append to the name of any overlapping columns.
+
 >>> A.merge(B, left_on='lkey', right_on='rkey', how='outer',
-    suffixes=('_left', '_right'))
+...         suffixes=('_left', '_right'))
   lkey  value_left rkey  value_right
 0  foo           1  foo            5
 1  foo           1  foo            8
@@ -266,10 +269,13 @@
 4  bar           2  bar            6
 5  baz           3  baz            7
 
+Merge DataFrames A and B, but throw an error if the DataFrames have
+any overlapping columns.
+
 >>> A.merge(B, left_on='lkey', right_on='rkey', how='outer',
-    suffixes=(False, False))
+...         suffixes=(False, False))
 Traceback (most recent call last):
-    ...
+...
 ValueError: columns overlap but no suffix specified:
     Index(['value'], dtype='object')
 """