--- a/DialogBox.st	Fri Dec 16 16:13:19 2016 +0100
+++ b/DialogBox.st	Fri Dec 16 16:46:39 2016 +0100
@@ -1847,7 +1847,7 @@
     "launch a Dialog, which allows user to enter yes, no and cancel.
      Return true for 'yes', false for 'no', nil for 'cancel'.
      The strings for cancel, no and yes are to be passed in
-     buttonLabels; 
+     buttonLabels, with cancel/abort being the first. 
      The default argument (if non-nil) defines the index of the 
      return button (1 to 3)"
 
@@ -1874,7 +1874,7 @@
     "launch a Dialog, which allows user to click on any button.
      Return the corresponding value from the values array.
      The labels for the buttons are to be passed in
-     buttonLabels; 
+     buttonLabels, with cancel/abort being the first. 
      The default argument (if non-nil) defines the index of the 
      return button (1 to n)"
 
@@ -1900,6 +1900,8 @@
 !
 
 confirmWithCancel:aString labels:buttonLabels values:buttonValues default:default boxLabel:boxLabelOrNil
+    <resource: #obsolete>
+
     "obsolete - for backward compatibility"
 
     ^ self
@@ -1916,7 +1918,7 @@
     "launch a Dialog, which allows user to click on any button.
      Return the corresponding value from the values array.
      The labels for the buttons are to be passed in
-     buttonLabels;
+     buttonLabels, with cancel/abort being the first.
      The default argument (if non-nil) defines the index of the return button (1 to n).
      If checkLabel/checkHolder are not nil, and additional labelled checkBox is added to operate on
      checkHolder. This can be used for 'do not show this box again' checkItems."
@@ -1986,7 +1988,7 @@
     "launch a Dialog, which allows user to click on any button.
      Return the corresponding value from the values array.
      The labels for the buttons are to be passed in
-     buttonLabels;
+     buttonLabels, with cancel/abort being the first.
      The default argument (if non-nil) defines the index of the
      return button (1 to n)"