Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

Diff of /docs/trunk/oodialog/en-US/userdialog.xml [r8557] .. [r8558] Maximize Restore

  Switch to side-by-side view

--- a/docs/trunk/oodialog/en-US/userdialog.xml
+++ b/docs/trunk/oodialog/en-US/userdialog.xml
@@ -446,7 +446,7 @@
     <varlistentry><term>id [required]</term>
     <listitem>
     <para>
-      The <xref linkend="paraResourceIDs"/> for the icon. This can be numeric or <xref linkend="defSymbolicId"/>.
+      The <xref linkend="idArgument"/> for the icon. This can be numeric or <xref linkend="defSymbolicId"/>.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>fileName [required]</term>
@@ -991,7 +991,7 @@
   <para>
     For all the create... methods, the arguments are always in the same order. Although, for some of the methods, some
     arguments may be required and in other of the methods the arguments may be optional. The order is exactly:
-    resourceID, control <xref linkend="paraControlCoordinates"/>, style option, text if any, attribute
+    resourceID, control <xref linkend="controlCoordinatesArgument"/>, style option, text if any, attribute
     name if any, methodName to connect, if any.
   </para>
   </listitem>
@@ -1017,18 +1017,23 @@
   role="italic">defineDialog</emphasis> method as recommended, then he does not need to worry about invoking the methods
   at the wrong time.
 </para>
-<para id="paraStyleExplanation" xreflabel="style">
-  The behavior and appearance of all dialog controls defined using one of the create... methods are controlled by a
-  style option.  For each of the create... methods, one of the arguments consists of a set of keywords that define the
-  style of the control being defined.  These keywords allow the programmer to change the default behavior and  / or
-  appearance of the control.
-</para>
-<para>
-  An attempt is made for each method to list all the style keywords that will be accepted. However, the behaviour and
-  appearance that the specified style gives any particular control is determined by the operating system, not ooDialog.
-  For many of the dialog controls, certain combinations of styles do not make much sense. It is up to the individual
-  programmer to decide whether a style is appropriate for her program.
-</para>
+<variablelist>
+  <varlistentry id="styleExplanation" xreflabel="style"><term><emphasis role="bold">Style argument:</emphasis></term>
+  <listitem>
+  <para>
+    The behavior and appearance of all dialog controls defined using one of the create... methods are controlled by a
+    style option.  For each of the create... methods, one of the arguments consists of a set of keywords that define the
+    style of the control being defined.  These keywords allow the programmer to change the default behavior and  / or
+    appearance of the control.
+  </para>
+  <para>
+    An attempt is made for each method to list all the style keywords that will be accepted. However, the behaviour and
+    appearance that the specified style gives any particular control is determined by the operating system, not ooDialog.
+    For many of the dialog controls, certain combinations of styles do not make much sense. It is up to the individual
+    programmer to decide whether a style is appropriate for her program.
+  </para>
+  </listitem></varlistentry>
+</variablelist>
 <para>
   There are five styles that all dialog controls share:
 </para>
@@ -1132,21 +1137,27 @@
   </para>
   </listitem></varlistentry>
 </variablelist>
-<para id="paraControlCoordinates" xreflabel="co-ordinates">
-  All dialog controls have a position and size. The position of the control is specified by the coordinates of its upper
-  left corner (x, y) and the size is specified by its width (cx) and height (cy).  Windows uses a coordinate system that
-  specifies the upper left corner of the screen as (0,0). Moving to the left in this system increases the x value and
-  moving down increases the y value.  Negative values for either x or y would then move off the screen. (Normally. This
-  simple explanation becomes more complicated with dual-monitor systems.)
-</para>
 <para>
-  For the create... methods all coordinates, (the x, y, cx, and cy arguments,) are specified in
-  <xref linkend="defDialogUnit"/>s. The position of the dialog control is specified in relation to the upper left corner of
-  the dialog's <xref linkend="defClientArea"/>. All the create... methods that create a single control have the following
-  common arguments.  Some of the other create... methods that create a group of controls will only take the position, or the
-  size arguments:
+  All dialog controls have a position and size.
 </para>
 <variablelist>
+  <varlistentry><term id="controlCoordinatesArgument" xreflabel="co-ordinates"><emphasis role="bold">Co-ordinates</emphasis></term>
+  <listitem>
+  <para>
+    The position of the control is specified by the coordinates of its upper left corner (x, y) and the size is specified by
+    its width (cx) and height (cy).  Windows uses a coordinate system that specifies the upper left corner of the screen as
+    (0,0). Moving to the left in this system increases the x value and moving down increases the y value.  Negative values
+    for either x or y would then move off the screen. (Normally. This simple explanation becomes more complicated with
+    dual-monitor systems.)
+  </para>
+  <para>
+    For the create... methods all coordinates, (the x, y, cx, and cy arguments,) are specified in
+    <xref linkend="defDialogUnit"/>s. The position of the dialog control is specified in relation to the upper left corner of
+    the dialog's <xref linkend="defClientArea"/>. All the create... methods that create a single control have the following
+    common arguments.  Some of the other create... methods that create a group of controls will only take the position, or the
+    size arguments:
+  </para>
+  </listitem></varlistentry>
   <varlistentry><term id="xArgument"><emphasis role="bold">x</emphasis></term>
   <listitem>
   <para>
@@ -1173,7 +1184,7 @@
   </listitem></varlistentry>
   <varlistentry><term id="idArgument" xreflabel="resource ID"><emphasis role="bold">id</emphasis></term>
   <listitem>
-  <para id="paraResourceIDs" xreflabel="resource ID">
+  <para>
     All dialog controls have a numeric <xref linkend="defResourceId"/>. The ooDialog framework is designed to accept a
     <xref linkend="defSymbolicId"/> ID anywhere a resource ID is needed.  All the create... methods accepted a symbolic ID
     for the id argument.
@@ -1249,13 +1260,13 @@
     <varlistentry><term>x, y [required]</term>
     <listitem>
     <para>
-      The  control's position <xref linkend="paraControlCoordinates"/>.
+      The  control's position <xref linkend="controlCoordinatesArgument"/>.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>cx, cy [optional]</term>
     <listitem>
     <para>
-      The  control's width and height <xref linkend="paraControlCoordinates"/>. If omitted the button
+      The  control's width and height <xref linkend="controlCoordinatesArgument"/>. If omitted the button
       will be created with 0 width and height. The programmer would be responsible for resizing the button after the
       underlying dialog is created. This makes sense when the programmer wants to size the button to match the exact
       size of the loaded bitmap(s).
@@ -1496,14 +1507,14 @@
       <varlistentry><term>x [required], y [required], cx [optional], cy [optional]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/> If cx or cy are omitted, then the size for
+        The  control <xref linkend="controlCoordinatesArgument"/> If cx or cy are omitted, then the size for
         the check box is calculated internally using its label.
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces:
       </para>
       <para>
@@ -1818,14 +1829,14 @@
       <varlistentry><term>x, y [required]</term>
       <listitem>
       <para>
-        The position <xref linkend="paraControlCoordinates"/> of the group of check boxes.  x and y
+        The position <xref linkend="controlCoordinatesArgument"/> of the group of check boxes.  x and y
         name the position of the first check box control. The other check boxes are positioned automatically.
       </para>
       </listitem></varlistentry>
       <varlistentry><term>cx [optional]</term>
       <listitem>
       <para>
-        The width <xref linkend="paraControlCoordinates"/> of as single check box, plus its text. If
+        The width <xref linkend="controlCoordinatesArgument"/> of as single check box, plus its text. If
         omitted, the space needed for the check box and its text is calculated by the ooDialog framework.
       </para>
       </listitem></varlistentry>
@@ -1840,7 +1851,7 @@
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces. Each check box in the group is given the style specified by this option.
       </para>
       <para>
@@ -2092,14 +2103,14 @@
       <varlistentry><term>x, y [required]</term>
       <listitem>
       <para>
-        The position <xref linkend="paraControlCoordinates"/> for the check box group. The group is
+        The position <xref linkend="controlCoordinatesArgument"/> for the check box group. The group is
         positioned so that the upper left corner of the group is at the x, y coordinates specified.
       </para>
       </listitem></varlistentry>
       <varlistentry><term>cx [optional]</term>
       <listitem>
       <para>
-        The width <xref linkend="paraControlCoordinates"/> for a single check box plus its label.
+        The width <xref linkend="controlCoordinatesArgument"/> for a single check box plus its label.
         If omitted, the proper width is calculated by the ooDialog framework.
       </para>
       </listitem></varlistentry>
@@ -2124,7 +2135,7 @@
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces. Each check box in the group is given the style specified by this option.
       </para>
       <para>
@@ -2396,13 +2407,13 @@
     <varlistentry><term>x, y, cx, cy [required]</term>
     <listitem>
     <para>
-      The  control <xref linkend="paraControlCoordinates"/>.
+      The  control <xref linkend="controlCoordinatesArgument"/>.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more <xref linkend="paraStyleExplanation"/> keywords separated by
+      A list of 0 or more <xref linkend="styleExplanation"/> keywords separated by
       spaces:
     </para>
     <para>
@@ -2768,13 +2779,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces:
       </para>
       <para>
@@ -3013,14 +3024,14 @@
       <varlistentry><term>x, y [required]</term>
       <listitem>
       <para>
-        The <xref linkend="paraControlCoordinates"/> of the position of the upper left corner of the
+        The <xref linkend="controlCoordinatesArgument"/> of the position of the upper left corner of the
         button group.
       </para>
       </listitem></varlistentry>
       <varlistentry><term>cx, cy [optional]</term>
       <listitem>
       <para>
-        The width and height <xref linkend="paraControlCoordinates"/> of a single button. Both cx and
+        The width and height <xref linkend="controlCoordinatesArgument"/> of a single button. Both cx and
         cy are optional. The default for cx is 40 and for cy 12.
       </para>
       </listitem></varlistentry>
@@ -3053,7 +3064,7 @@
       <varlistentry><term>o [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords separated by
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords separated by
         spaces. Each button is given the same set of styles, except for the DEFAULT style. If the style arg contains the
         DEFAULT keyword, it is only given to the first button:
       </para>
@@ -3279,7 +3290,7 @@
     <varlistentry><term>x, y [optional]</term>
     <listitem>
     <para>
-      The <xref linkend="paraControlCoordinates"/> of the position of the upper left corner of the
+      The <xref linkend="controlCoordinatesArgument"/> of the position of the upper left corner of the
       button group. If either x or y is omitted, then the position of the upper left corner is calculated. The calculated
       position takes into account the size of the buttons along with the <emphasis role="italic">r</emphasis> and <emphasis
       role="italic">align</emphasis> arguments. See the remarks section for details.
@@ -3288,7 +3299,7 @@
     <varlistentry><term>cx, cy [optional]</term>
     <listitem>
     <para>
-      The width and height <xref linkend="paraControlCoordinates"/> of a single button. Both cx and
+      The width and height <xref linkend="controlCoordinatesArgument"/> of a single button. Both cx and
       cy are optional. If either cx or cy is omitted, then both cx and cy are calculated. The calculation is based on the
       size taken up by the largest label in all the buttons.
     </para>
@@ -3370,7 +3381,7 @@
       <varlistentry><term><emphasis role="bold">.OPTS</emphasis> [optional]</term>
       <listitem>
       <para>
-        This index specifes the <xref linkend="paraStyleExplanation"/> for the button. The value of the index is a list of 0
+        This index specifes the <xref linkend="styleExplanation"/> for the button. The value of the index is a list of 0
         or more of the following keywords separated by spaces. If this index is omitted for any button, the empty string is
         used:
       </para>
@@ -3652,7 +3663,7 @@
       <varlistentry><term>x [required], y [required], cx [optional], cy [optional]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>. If either cx or cy are
+        The  control <xref linkend="controlCoordinatesArgument"/>. If either cx or cy are
         omitted, then the size for the radio button is calculated internally using its label. (The
         text argument.)
       </para>
@@ -3660,7 +3671,7 @@
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords separated by
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords separated by
         spaces:
       </para>
       <para>
@@ -3962,7 +3973,7 @@
       <varlistentry><term>x [required], y [required], cx [optional]</term>
       <listitem>
       <para>
-        The control <xref linkend="paraControlCoordinates"/>.  x and y name the position of the first
+        The control <xref linkend="controlCoordinatesArgument"/>.  x and y name the position of the first
         radio button control. The other radio buttons are positioned automatically. cx specifies the length of the radio
         button plus text. If omitted, the space needed is calculated.
       </para>
@@ -3978,7 +3989,7 @@
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords separated by
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords separated by
         spaces. Each radio button in the group is given the style specified by this option.
       </para>
       <para>
@@ -4218,14 +4229,14 @@
       <varlistentry><term>x, y [required]</term>
       <listitem>
       <para>
-        The control position <xref linkend="paraControlCoordinates"/>.  x and y name the position of
+        The control position <xref linkend="controlCoordinatesArgument"/>.  x and y name the position of
         the first radio button control. The other radio buttons are positioned automatically.
       </para>
       </listitem></varlistentry>
       <varlistentry><term>cx [optional]</term>
       <listitem>
       <para>
-        The control width <xref linkend="paraControlCoordinates"/>. cx specifies the length of the radio
+        The control width <xref linkend="controlCoordinatesArgument"/>. cx specifies the length of the radio
         button plus text. If omitted, the space needed is calculated.
       </para>
       </listitem></varlistentry>
@@ -4249,7 +4260,7 @@
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords separated by
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords separated by
         spaces. Each radio button in the group is given the style specified by this option.
       </para>
       <para>
@@ -4520,13 +4531,13 @@
     <varlistentry><term>x, y, cx, cy [required]</term>
     <listitem>
     <para>
-      The combo box <xref linkend="paraControlCoordinates"/>.
+      The combo box <xref linkend="controlCoordinatesArgument"/>.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
       separated by spaces:
     </para>
     <para>
@@ -4758,13 +4769,13 @@
     <varlistentry><term>x, y [required]</term>
     <listitem>
     <para>
-      The position <xref linkend="paraControlCoordinates"/> of the input group.
+      The position <xref linkend="controlCoordinatesArgument"/> of the input group.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>cx1 [optional]</term>
     <listitem>
     <para>
-      The width <xref linkend="paraControlCoordinates"/> of the static text control used for the
+      The width <xref linkend="controlCoordinatesArgument"/> of the static text control used for the
       label. If omitted, the width is calculated automatically using the dialog font. The height of the label is
       always calculated automatically using the dialog font.
     </para>
@@ -4772,13 +4783,13 @@
     <varlistentry><term>cx2 [required]</term>
     <listitem>
     <para>
-      The  width <xref linkend="paraControlCoordinates"/> of the combo box.
+      The  width <xref linkend="controlCoordinatesArgument"/> of the combo box.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>count [optional]</term>
     <listitem>
     <para>
-      The  height <xref linkend="paraControlCoordinates"/> of the combo box specified as a number
+      The  height <xref linkend="controlCoordinatesArgument"/> of the combo box specified as a number
       of lines. The height of one line if text is calculated using the dialog font. This height is used for the height
       of the label. The <emphasis role="italic">count</emphasis> argument then specifies how many lines. of that
       height, the combo box should be. The default is 5 lines.
@@ -4793,7 +4804,7 @@
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
       separated by spaces:
     </para>
     <para>
@@ -4974,13 +4985,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces. <emphasis role="bold">Note</emphasis> that the LONG, SHORT, CENTURY, and TIME styles are
         mutually exclusive. If the programmer specifies more than one of those style keywords, only one of the styles will
         be in effect. Which style is in effect is undefined.
@@ -5204,20 +5215,20 @@
     <varlistentry><term>x, y, cx [required]</term>
     <listitem>
     <para>
-      The control position and width <xref linkend="paraControlCoordinates"/>.
+      The control position and width <xref linkend="controlCoordinatesArgument"/>.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>cy [optional]</term>
     <listitem>
     <para>
-      The height <xref linkend="paraControlCoordinates"/> for the control. If omitted, then the height
+      The height <xref linkend="controlCoordinatesArgument"/> for the control. If omitted, then the height
       is calculated automatically to fit the height of the dialog font.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
       separated by spaces:
     </para>
     <para>
@@ -5314,7 +5325,7 @@
           Selected text in an edit control keeps its highlight when the focus is shifted away from the control.
         </para>
         </listitem></varlistentry>
-        <varlistentry id="styleEditPASSWORD" xreflabel="PASSWORD"><term>PASSWORD</term>
+        <varlistentry id="styEditPASSWORD" xreflabel="PASSWORD"><term>PASSWORD</term>
         <listitem>
         <para>
           Characters typed into the edit control are masked.  Rather than displaying the character typed, the edit control
@@ -5496,7 +5507,7 @@
     <varlistentry><term>x, y, cx2 [required]</term>
     <listitem>
     <para>
-      The position (x, y) <xref linkend="paraControlCoordinates"/> of the pair of controls, along with
+      The position (x, y) <xref linkend="controlCoordinatesArgument"/> of the pair of controls, along with
       the width coordinate of the edit control. x and y are the position of the upper-left edge of the label. The edit
       control is aligned automatically. cx2 is the width of the edit control.
     </para>
@@ -5504,7 +5515,7 @@
     <varlistentry><term>cx1, cy [optional]</term>
     <listitem>
     <para>
-      cx1 is the width <xref linkend="paraControlCoordinates"/> of the static control. If omitted, this
+      cx1 is the width <xref linkend="controlCoordinatesArgument"/> of the static control. If omitted, this
       width is calculated by the ooDialog framework. cy is the height cooridinates of the two controls. If it is
       omitted, it is also calculated automatically using the height of dialog font.
     </para>
@@ -5512,7 +5523,7 @@
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords,
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords,
       separated by spaces, used to set the style of the edit control.
     </para>
     <para>
@@ -5814,7 +5825,7 @@
     <varlistentry><term>x, y [required]</term>
     <listitem>
     <para>
-      The position <xref linkend="paraControlCoordinates"/> of the input group.
+      The position <xref linkend="controlCoordinatesArgument"/> of the input group.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>cx1 [optional]</term>
@@ -5845,7 +5856,7 @@
     <varlistentry><term>s [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
       separated by spaces. Each individual edit control is created with the style specified.
     </para>
     <para>
@@ -6139,7 +6150,7 @@
     <varlistentry><term>x, y [required]</term>
     <listitem>
       <para>
-        The position <xref linkend="paraControlCoordinates"/> of the input group.
+        The position <xref linkend="controlCoordinatesArgument"/> of the input group.
       </para>
     </listitem></varlistentry>
     <varlistentry><term>cx1 [optional]</term>
@@ -6165,7 +6176,7 @@
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords separated by
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords separated by
       spaces. This specifies the style for the edit control(s) in the group. Each edit control is assigned the same
       style.
     </para>
@@ -6447,7 +6458,7 @@
   template with the PASSWORD style.
 </para>
 <para>
-  When an edit control has the <xref linkend="styleEditPASSWORD"/> style it does not echo the characters typed but displays
+  When an edit control has the <xref linkend="styEditPASSWORD"/> style it does not echo the characters typed but displays
   the password character instead. This method is a convenience method and is used exactly like the <xref
   linkend="mthCreateEdit"/> method.  It simple specifies the PASSWORD style automatically for the programmer.
 </para>
@@ -6467,20 +6478,20 @@
     <varlistentry><term>x, y, cx [required]</term>
     <listitem>
     <para>
-      The position and width <xref linkend="paraControlCoordinates"/> for the control.
+      The position and width <xref linkend="controlCoordinatesArgument"/> for the control.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>cy [optional]</term>
     <listitem>
     <para>
-      The height <xref linkend="paraControlCoordinates"/> for the control. If this argument is omitted,
+      The height <xref linkend="controlCoordinatesArgument"/> for the control. If this argument is omitted,
       then the height is calculated to fit the height of the dialog font.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
       separated by spaces.
     </para>
     <para>
@@ -6734,13 +6745,13 @@
     <varlistentry><term>x, y, cx, cy [required]</term>
     <listitem>
     <para>
-      The  control <xref linkend="paraControlCoordinates"/>.
+      The  control <xref linkend="controlCoordinatesArgument"/>.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
       separated by spaces:
     </para>
     <para>
@@ -6961,13 +6972,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces:
       </para>
       <para>
@@ -7056,13 +7067,15 @@
             Sorts items by item text in descending order.
           </para>
           </listitem></varlistentry>
-          <varlistentry><term>EDIT</term>
-          <listitem>
-          <para>
-            The list-view allows the user to edit the list-view items. To store the edited text, you must connect a method
-            to the <xref linkend="evtListViewENDEDIT"/> <xref linkend="ovvEvents"/> notification using the <xref
-            linkend="mthConnectListViewEvent"/> method. Alternatively you can connect the <xref
-            linkend="kywListViewDEFAULTEDIT"/> event handler using <emphasis role="italic">connectListViewEvent</emphasis>.
+          <varlistentry id="styListViewEDIT" xreflabel="EDIT"><term>EDIT</term>
+          <listitem>
+          <para>
+            With this style, the list-view allows the user to edit the list-view item labels. To have an edited label take
+            effect, the programmer must connect an <link linkend="ovvEvents">event</link> notification using the <xref
+            linkend="mthConnectListViewEvent"/> method. For the most flexibility with edit labeling, connect both the <xref
+            linkend="evtListViewBEGINEDIT"/> and <xref linkend="evtListViewENDEDIT"/> notifications.  Alternatively the <xref
+            linkend="evtListViewDEFAULTEDIT"/> event could be connected using the <emphasis
+            role="italic">connectListViewEvent</emphasis> method.
           </para>
           </listitem></varlistentry>
           <varlistentry><term>HSCROLL</term>
@@ -7250,13 +7263,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces:
       </para>
       <para>
@@ -7467,13 +7480,13 @@
     <varlistentry><term>x, y, cx, cy [required]</term>
     <listitem>
     <para>
-      The control <xref linkend="paraControlCoordinates"/>.
+      The control <xref linkend="controlCoordinatesArgument"/>.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords separated by
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords separated by
       spaces.
     </para>
     <para>
@@ -7621,13 +7634,13 @@
     <varlistentry><term>x, y, cx, cy [required]</term>
     <listitem>
     <para>
-      The  control <xref linkend="paraControlCoordinates"/>.
+      The  control <xref linkend="controlCoordinatesArgument"/>.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
       separated by spaces:
     </para>
     <para>
@@ -7793,13 +7806,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces.
       </para>
       <para>
@@ -7929,13 +7942,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces.
       </para>
       <para>
@@ -8064,13 +8077,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces.
       </para>
       <para>
@@ -8199,13 +8212,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The control <xref linkend="paraControlCoordinates"/>
+        The control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords separated by spaces.
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords separated by spaces.
       </para>
       <para>
         <simplelist type='vert' columns='3'>
@@ -8333,13 +8346,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces.
       </para>
       <para>
@@ -8469,13 +8482,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces.
       </para>
       <para>
@@ -8605,13 +8618,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces.
       </para>
       <para>
@@ -8742,13 +8755,13 @@
     <varlistentry><term>x, y, cx, cy [required]</term>
     <listitem>
     <para>
-      The  control <xref linkend="paraControlCoordinates"/>
+      The  control <xref linkend="controlCoordinatesArgument"/>
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more <xref linkend="paraStyleExplanation"/> keywords separated by spaces.
+      A list of 0 or more <xref linkend="styleExplanation"/> keywords separated by spaces.
     </para>
     <para>
       <simplelist type='vert' columns='3'>
@@ -9132,13 +9145,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more <xref linkend="paraStyleExplanation"/> keywords separated by spaces. If this
+        A list of 0 or more <xref linkend="styleExplanation"/> keywords separated by spaces. If this
         argument is omitted, the default is WHITERECT.
       </para>
       <para>
@@ -9341,13 +9354,13 @@
     <varlistentry><term>x, y, cx, cy [required]</term>
     <listitem>
     <para>
-      The  control <xref linkend="paraControlCoordinates"/>
+      The  control <xref linkend="controlCoordinatesArgument"/>
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more <xref linkend="paraStyleExplanation"/> keywords separated by spaces. If this
+      A list of 0 or more <xref linkend="styleExplanation"/> keywords separated by spaces. If this
       argument is omitted, the default is ICON.
     </para>
     <para>
@@ -9567,14 +9580,14 @@
     <varlistentry><term>x [required], y [required], cx [optional], cy [optional]</term>
     <listitem>
     <para>
-      The control <xref linkend="paraControlCoordinates"/>. When cx and cy are omitted, then width and height of the control
+      The control <xref linkend="controlCoordinatesArgument"/>. When cx and cy are omitted, then width and height of the control
       are calculated automatically based on the width and height of the text string.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more <xref linkend="paraStyleExplanation"/> keywords separated by spaces.  If this
+      A list of 0 or more <xref linkend="styleExplanation"/> keywords separated by spaces.  If this
       argument is omitted LEFT is the default.
     </para>
     <para>
@@ -9893,13 +9906,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces.
       </para>
       <para>
@@ -10029,13 +10042,13 @@
     <varlistentry><term>x, y, cx, cy [required]</term>
     <listitem>
     <para>
-      The  control <xref linkend="paraControlCoordinates"/>
+      The  control <xref linkend="controlCoordinatesArgument"/>
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
       separated by spaces.
     </para>
     <para>
@@ -10168,13 +10181,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces:
       </para>
       <para>
@@ -10389,13 +10402,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords separated by
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords separated by
         spaces:
       </para>
       <para>
@@ -10615,13 +10628,13 @@
     <varlistentry><term>x, y, cx, cy [required]</term>
     <listitem>
     <para>
-      The tree view <xref linkend="paraControlCoordinates"/>.
+      The tree view <xref linkend="controlCoordinatesArgument"/>.
     </para>
     </listitem></varlistentry>
     <varlistentry><term>style [optional]</term>
     <listitem>
     <para>
-      A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+      A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
       separated by spaces:
     </para>
     <para>
@@ -10649,7 +10662,7 @@
           The tree view has lines linking child items to the root of the hierarchy.
         </para>
         </listitem></varlistentry>
-        <varlistentry id="styButtonsClsTreeView" xreflabel="BUTTONS"><term>BUTTONS</term>
+        <varlistentry id="styTreeViewBUTTONS" xreflabel="BUTTONS"><term>BUTTONS</term>
         <listitem>
         <para>
           The tree view adds a button to the left of each parent item.
@@ -10836,13 +10849,13 @@
       <varlistentry><term>x, y, cx, cy [required]</term>
       <listitem>
       <para>
-        The  control <xref linkend="paraControlCoordinates"/>
+        The  control <xref linkend="controlCoordinatesArgument"/>
       </para>
       </listitem></varlistentry>
       <varlistentry><term>style [optional]</term>
       <listitem>
       <para>
-        A list of 0 or more of the following <xref linkend="paraStyleExplanation"/> keywords
+        A list of 0 or more of the following <xref linkend="styleExplanation"/> keywords
         separated by spaces:
       </para>
       <para>