Documentation for QGraphicsItem::setCacheMode is wrong

This statement is wrong: "When enabled, the item's paint() function will be called only once for each call to update(); for any subsequent repaint requests, the Graphics View framework will redraw from the cache."

The cached pixmap is also cleared from the Qt side, internally, without prior update request. Please clarify how this cache is supposed to be used.