--- a/EditTextView.st	Thu Sep 03 11:41:01 2015 +0200
+++ b/EditTextView.st	Thu Sep 03 11:44:51 2015 +0200
@@ -1310,12 +1310,16 @@
 
 contents:aStringOrStringCollectionOrNil
     "replace the whole contents by something new.
-     this is not undoably, unless you care for yourself"
+     this is not undoably, unless you care for yourself.
+     See replaceContentsWith:newContents for an undoable version of this"
 
     self contents:aStringOrStringCollectionOrNil keepUndoHistory:false.
 !
 
 contents:something keepUndoHistory:keepUndoHistory
+    "set the contents and optionally clear the undo history.
+     The contents-change is not undoable."
+
     super contents:something.
     keepUndoHistory ifFalse:[
         undoSupport resetHistories.