diff -r c4d8f4c74c26 -r 38ea269664f8 UISpecificationTool.st
--- a/UISpecificationTool.st	Wed Oct 22 16:42:42 1997 +0200
+++ b/UISpecificationTool.st	Thu Oct 23 15:35:19 1997 +0200
@@ -68,8 +68,8 @@
 #showRoot
 'show or hide the first element into the hierarchical list.'
 
-#tabOrientation
-'where to place the tabs'
+#useIndex
+'set/clear the useIndex flag. If set, the index of the selection is used otherwise the selected string.'
 
 #menuHolder
 'selector or holder of the middle button menu'
@@ -90,13 +90,13 @@
 'set the maximum number of characters that are allowed in the editfield.'
 
 #action
-'action evaluated when the button is pressed or released which depends on the setting of triggerOnDown flag, either set the press-action and clear any release-action or vice versa, set the release-action and clear the press-action.'
+'action selector sent to the application when the button is activated. (either on-press or on-release; this depends on the setting of triggerOnDown flag). The selector may be for a one-arg message; in this case, the argument is passed (a string).'
 
 #canvasSelector
 'after open the application specified by the clientKey, this selector if not nil will be evaluated,'
 
 #enableChannel
-'enable the view - selection changes are allowed'
+'enable the view - selection changes are allowed.  This field specifies the name of the aspect (-method or binding) in your application, which is supposed to return a valueHolder holding on to the enable-flag.'
 
 #middleButtonPressed
 'called if the middle button is pressed; you can open a menu'
@@ -117,10 +117,10 @@
 'the widget class shown represented by the arbitrary component or a selector which returns a widget class.'
 
 #id
-'enter the name of the field here. This ID can be used by the application to access components, using #componentAt:<key>'
+'enter the name of the field here. This ID can be used by the application to access components, using #componentAt:<ID>'
 
 #sizeAsDefault
-'the size of the widget depends on its label. In case of a fixed Layout nothing will change.'
+'let the widget compute its size to include space for the default (return) image. Useful for buttons which are not default buttons initially, but may become a default button dynamically.'
 
 #selectionHolder
 'the one which keeps the selection.'
@@ -159,7 +159,7 @@
 'show or hide lines'
 
 #label
-'the label of the widget'
+'the label of the widget. If ''label is image'' is off, this is the label string. Otherwise, it specifies the applications selector, which returns the label - either a string or a bitmap image.'
 
 #minorKey
 'the selector specifies which interface specification to be used. The selector must return an interfaceSpec. On default the #windowSpec method is used'
@@ -168,7 +168,7 @@
 'show the frame'
 
 #autoRepeat
-'repeat the action as long as the button is pressed; to have this behavior the ''isTriggerOnDown'' state must be enabled'
+'repeat the action as long as the button is pressed; to have this behavior the ''isTriggerOnDown'' state must be enabled.'
 
 #booleanHolder
 'a boolean holder which keeps the state'
@@ -198,20 +198,20 @@
 'called whenever the selection changed. If the selector ends with '':'' the method is invoked with the current selection.'
 
 #fontMenu
-'set the font for the widget'
+'set the font for the widget if the font-checkBox is turned on. Otherwise, the widget uses its default font (which is specified in the viewStyle).'
 
 #doubleClickSelector
 'define the double click action which is evaluated on double click in case of a none nil selection. If the selector ends with '':'' the method is invoked with the current selection.'
 
+#tabOrientation
+'where to place the tabs'
+
 #isTriggerOnDown
-'if true, the action is evaluated when the button is pressed'
+'if true, the action is evaluated when the button is pressed; otherwise, when released.'
 
 #borderWidth
 'width of the border'
 
-#useIndex
-'set/clear the useIndex flag. If set, the index of the selection is used otherwise the selected string.'
-
 )
 ! !