diff --git a/src/c_client.py b/src/c_client.py
index b7db543..c16d90c 100644
--- a/src/c_client.py
+++ b/src/c_client.py
@@ -1626,13 +1626,13 @@ def _c_iterator(self, name):
 
     _h('')
     _h('/**')
-    _h(' * Return the iterator pointing to the last element')
+    _h(' * Return the iterator pointing to the position after the last element')
     _h(' * @param i An %s', self.c_iterator_type)
-    _h(' * @return  The iterator pointing to the last element')
+    _h(' * @return  The iterator pointing to the position after the last element')
     _h(' *')
-    _h(' * Set the current element in the iterator to the last element.')
-    _h(' * The member rem is set to 0. The member data points to the')
-    _h(' * last element.')
+    _h(' * Set the iterator to point to the position after the last')
+    _h(' * element. The member rem is set to 0. The member data points')
+    _h(' * to the position after the last element.')
     _h(' */')
     _c('')
     _hc('xcb_generic_iterator_t')