From bce77ba83e9be04f9b7a6184d086343dff6e69d2 Mon Sep 17 00:00:00 2001
From: jreback <jeff@reback.net>
Date: Mon, 6 Oct 2014 10:27:22 -0400
Subject: [PATCH] DOC: indexing.rst fixes w.r.t (GH8227)

---
 doc/source/indexing.rst | 69 +++++++++++++++++++++--------------------
 pandas/core/frame.py    |  2 +-
 2 files changed, 37 insertions(+), 34 deletions(-)

diff --git a/doc/source/indexing.rst b/doc/source/indexing.rst
index 7494f21b3ba71..8edd3e93759a6 100644
--- a/doc/source/indexing.rst
+++ b/doc/source/indexing.rst
@@ -1191,39 +1191,8 @@ The name, if set, will be shown in the console display:
    df
    df['A']
 
-
-Set operations on Index objects
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. _indexing.set_ops:
-
-The three main operations are ``union (|)``, ``intersection (&)``, and ``diff
-(-)``. These can be directly called as instance methods or used via overloaded
-operators:
-
-.. ipython:: python
-
-   a = Index(['c', 'b', 'a'])
-   b = Index(['c', 'e', 'd'])
-   a.union(b)
-   a | b
-   a & b
-   a - b
-
-Also available is the ``sym_diff (^)`` operation, which returns elements
-that appear in either ``idx1`` or ``idx2`` but not both. This is
-equivalent to the Index created by ``(idx1 - idx2) + (idx2 - idx1)``,
-with duplicates dropped.
-
-.. ipython:: python
-
-   idx1 = Index([1, 2, 3, 4])
-   idx2 = Index([2, 3, 4, 5])
-   idx1.sym_diff(idx2)
-   idx1 ^ idx2
-
-Setting index metadata (``name(s)``, ``levels``, ``labels``)
-------------------------------------------------------------
+Setting metadata
+~~~~~~~~~~~~~~~~
 
 .. versionadded:: 0.13.0
 
@@ -1261,6 +1230,40 @@ See :ref:`Advanced Indexing <advanced>` for usage of MultiIndexes.
   index.levels[1]
   index.set_levels(["a", "b"], level=1)
 
+Set operations on Index objects
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. _indexing.set_ops:
+
+.. warning::
+
+   In 0.15.0. the set operations ``+`` and ``-`` were deprecated in order to provide these for numeric type operations on certain
+   index types. ``+`` can be replace by ``.union()`` or ``|``, and ``-`` by ``.difference()``.
+
+The two main operations are ``union (|)``, ``intersection (&)``
+These can be directly called as instance methods or used via overloaded
+operators. Difference is provided via the ``.difference()`` method.
+
+.. ipython:: python
+
+   a = Index(['c', 'b', 'a'])
+   b = Index(['c', 'e', 'd'])
+   a | b
+   a & b
+   a.difference(b)
+
+Also available is the ``sym_diff (^)`` operation, which returns elements
+that appear in either ``idx1`` or ``idx2`` but not both. This is
+equivalent to the Index created by ``idx1.difference(idx2).union(idx2.difference(idx1))``,
+with duplicates dropped.
+
+.. ipython:: python
+
+   idx1 = Index([1, 2, 3, 4])
+   idx2 = Index([2, 3, 4, 5])
+   idx1.sym_diff(idx2)
+   idx1 ^ idx2
+
 Set / Reset Index
 -----------------
 
diff --git a/pandas/core/frame.py b/pandas/core/frame.py
index be98f977bf2bf..8342c587ae4bb 100644
--- a/pandas/core/frame.py
+++ b/pandas/core/frame.py
@@ -3752,7 +3752,7 @@ def append(self, other, ignore_index=False, verify_integrity=False):
                                 'ignore_index=True')
 
             index = None if other.name is None else [other.name]
-            combined_columns = self.columns.tolist() + (self.columns | other.index).difference(self.columns).tolist()
+            combined_columns = self.columns.tolist() + self.columns.union(other.index).difference(self.columns).tolist()
             other = other.reindex(combined_columns, copy=False)
             other = DataFrame(other.values.reshape((1, len(other))),
                               index=index, columns=combined_columns).convert_objects()