diff --git a/kivy/graphics/vertex_instructions.pyx b/kivy/graphics/vertex_instructions.pyx
index 88a561fb2..06167a46b 100644
--- a/kivy/graphics/vertex_instructions.pyx
+++ b/kivy/graphics/vertex_instructions.pyx
@@ -34,10 +34,11 @@ This module includes all the classes for drawing simple vertex objects.
                 self.triangle.points[3] = 400
 
     Although when the button is pressed the triangle coordinates will be
-    changed, the graphics will not be updated because the list itself is not
-    changed. Similarly, no updates will occur if syntax e.g
-    self.triangle.points[0:2] = [10,10] or self.triangle.points.insert(10) etc.
-    is used. To force an update after a change, the list variable itself must be
+    changed, the graphics will not be updated because the list itself has not
+    been changed. Similarly, no updates will occur using any syntax that changes
+    only elements of the list e.g. self.triangle.points[0:2] = [10,10] or
+    self.triangle.points.insert(10) etc.
+    To force an update after a change, the list variable itself must be
     changed, which in this case can be achieved with:
 
     .. code-block:: kv