From afa4b89f135716668bf29d494bdcfbb479fa4bfd Mon Sep 17 00:00:00 2001
From: Yaroslav Halchenko <debian@onerussian.com>
Date: Wed, 11 Jan 2012 13:21:04 -0500
Subject: [PATCH] DOC: added a note for behavior of append

---
 doc/source/merging.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/source/merging.rst b/doc/source/merging.rst
index 312da83ec33ac..f468ac44f843d 100644
--- a/doc/source/merging.rst
+++ b/doc/source/merging.rst
@@ -163,6 +163,12 @@ need to be:
    df2
    df1.append(df2)
 
+.. note::
+
+   Unlike `list.append` method, which appends to the original list and
+   returns nothing, ``append`` here **does not** modify ``df1`` and
+   returns its copy with ``df2`` appended.
+
 .. _merging.ignore_index:
 
 Ignoring indexes on the concatenation axis