From be5e2966e99999b11c2523e243b013cfdb1e00bf Mon Sep 17 00:00:00 2001
From: Ian Foote <ian@feete.org>
Date: Sat, 22 Jun 2013 12:48:54 +0100
Subject: [PATCH] Add warning about ListItemButton gotcha.

---
 kivy/uix/listview.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/kivy/uix/listview.py b/kivy/uix/listview.py
index f412e40e2..9f8acb294 100644
--- a/kivy/uix/listview.py
+++ b/kivy/uix/listview.py
@@ -283,6 +283,12 @@ either a cls or template.
     ListItemLabel and ListItemButton, or custom classes like them, and not the
     bare Label nor Button classes, are to be used in the listview system.
 
+.. warning::
+
+    ListItemButton inherits the `background_normal` and `background_down`
+    properties from the Button widget, so the `selected_color` and
+    `deselected_color` are not represented faithfully by default.
+
 Here is an args_converter for use with the built-in
 :class:`~kivy.uix.listview.ListItemButton`, specified as a normal Python
 function::