--- a/docs/trunk/oodialog/en-US/statusBar.xml
+++ b/docs/trunk/oodialog/en-US/statusBar.xml
@@ -144,7 +144,7 @@
 </variablelist>
 </para>
 
-<section id="sctMethodsStautBar"><title>Method Table</title>
+<section id="sctMethodsStatustBar"><title>Method Table</title>
 <para>
   The following table provides links to the documentation for the primary classes, methods, and attributes used in working
   with StatusBar objects, including the pertinent classes, and methods from other classes:
@@ -187,27 +187,27 @@
 </row>
 <row>
 <entry><xref linkend="mthGetBorders"/></entry>
-<entry>x.</entry>
+<entry>Returns an array of three integers containing the borders of the status bar.</entry>
 </row>
 <row>
 <entry><xref linkend="mthGetIconClsStatusBar"/></entry>
-<entry>x.</entry>
+<entry>Retrieves the icon image for the specified part.</entry>
 </row>
 <row>
 <entry><xref linkend="mthGetParts"/></entry>
-<entry>x.</entry>
+<entry>Returns the number of parts in the status bar, and optionally, the co-ordinate of the right edge of each part.</entry>
 </row>
 <row>
 <entry><xref linkend="mthGetRectClsStatusBar"/></entry>
-<entry>x.</entry>
+<entry>Returns a <xref linkend="clsRect"/>  object that contains the bounding rectangle of the specified part in this status bar.</entry>
 </row>
 <row>
 <entry><xref linkend="mthGetTextClsStatusBar"/></entry>
-<entry>x.</entry>
+<entry>Retrieves the text of the specified part and optionally some extra information related to the part.</entry>
 </row>
 <row>
 <entry><xref linkend="mthGetTextLength"/></entry>
-<entry>x.</entry>
+<entry></entry>
 </row>
 <row>
 <entry><xref linkend="mthGetTipText"/></entry>
@@ -235,7 +235,7 @@
 </row>
 <row>
 <entry><xref linkend="mthSetTextClsStatusBar"/></entry>
-<entry>x.</entry>
+<entry>Sets the text for the specified part.</entry>
 </row>
 <row>
 <entry><xref linkend="mthSetTipText"/></entry>
@@ -448,7 +448,7 @@
 </programlisting>
 
 <para>
-  Returns the number of parts in the status bar, and optionally, the co-ordinate of the right edge of each part
+  Returns the number of parts in the status bar, and optionally, the co-ordinate of the right edge of each part.
 </para>
 <variablelist>
   <varlistentry><term><emphasis role="bold">Arguments:</emphasis></term>
@@ -628,19 +628,58 @@
       <varlistentry><term><emphasis role="bold">DRAWTYPE:</emphasis></term>
       <listitem>
       <para>
-        A key word that specifies the type of operation used to draw the text.
+        A key word that specifies the type of operation used to draw the text. This will be exactly one of the following
+        keywords:
       </para>
+      <variablelist>
+        <varlistentry><term><emphasis role="bold">LOWERBORDERS</emphasis></term>
+        <listitem>
+        <para>
+          The text is drawn with a border to appear lower than the plane of the window.
+        </para>
+        </listitem></varlistentry>
+        <varlistentry><term><emphasis role="bold">NOBORDERS</emphasis></term>
+        <listitem>
+        <para>
+          The text is drawn without borders.
+        </para>
+        </listitem></varlistentry>
+        <varlistentry><term><emphasis role="bold">NOTABPARSING</emphasis></term>
+        <listitem>
+        <para>
+          Tab characters are ignored. See the <emphasis role="italic">Remarks</emphasis> section.
+        </para>
+        </listitem></varlistentry>
+        <varlistentry><term><emphasis role="bold">OWNERDRAW</emphasis></term>
+        <listitem>
+        <para>
+          The text is drawn by the parent window. Owner draw is not currenly supported by the ooDialog framework.
+        </para>
+        </listitem></varlistentry>
+        <varlistentry><term><emphasis role="bold">POPOUT</emphasis></term>
+        <listitem>
+        <para>
+          The text is drawn with a border to appear higher than the plane of the window.
+        </para>
+        </listitem></varlistentry>
+        <varlistentry><term><emphasis role="bold">RTLREADING</emphasis></term>
+        <listitem>
+        <para>
+          The text will be displayed in the opposite direction to the text in the parent window.
+        </para>
+        </listitem></varlistentry>
+      </variablelist>
       </listitem></varlistentry>
       <varlistentry><term><emphasis role="bold">TEXTLENGTH:</emphasis></term>
       <listitem>
       <para>
-        xxx and xxx sss.
+        The length of the text string.
       </para>
       </listitem></varlistentry>
       <varlistentry><term><emphasis role="bold">TEXT:</emphasis></term>
       <listitem>
       <para>
-        The text of the specified part.
+        The text of the specified part. This will be the same string as the return value for this method.
       </para>
       </listitem></varlistentry>
     </variablelist>
@@ -650,13 +689,14 @@
   <varlistentry><term><emphasis role="bold">Return value:</emphasis></term>
   <listitem>
   <para>
-    xx
-  </para>
-  </listitem></varlistentry>
-  <varlistentry><term><emphasis role="bold">Remarks:</emphasis></term>
-  <listitem>
-  <para>
-    Additional comments.
+    The text for the specified part.
+  </para>
+  </listitem></varlistentry>
+  <varlistentry><term><emphasis role="bold">Remarks</emphasis></term>
+  <listitem>
+  <para>
+    By default text is left-aligned. This can be changed by embedding tab characters in the text. Text to the right of a
+    single tab character is center-aligned. Text to the right of 2 tab characters is right-aligned.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Details</emphasis></term>
@@ -664,14 +704,11 @@
   <para>
     Raises syntax errors when incorrect usage is detected.
   </para>
-  <para>
-    Sets the <link linkend="dotSystemErrorCode">.SystemErrorCode</link> variable.
-  </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Example:</emphasis></term>
   <listitem>
   <para>
-    This example ...
+    This example retrieves the text and the extra info for all the parts in a status bar:
 <programlisting>
 <![CDATA[
 ::method onTest2 unguarded
@@ -725,13 +762,13 @@
 <indexterm><primary>StatusBar class</primary><secondary>getTextLength</secondary></indexterm>
 <programlisting>
 <![CDATA[
->>--getTextLength(--+--------+--)---------------------------------------------><
-                  +--type--+
-]]>
-</programlisting>
-
-<para>
-  xx
+>>--getTextLength(--index--+---------+--)--------><
+                           +-,-info--+
+]]>
+</programlisting>
+
+<para>
+  Gets the length of the text for the specified pard of the status bar, and optionally the drawing technique of the text.
 </para>
 <variablelist>
   <varlistentry><term><emphasis role="bold">Arguments:</emphasis></term>
@@ -740,44 +777,85 @@
     The arguments are:
   </para>
   <variablelist>
-    <varlistentry><term>TERM</term>
-    <listitem>
-    <para>
-      xx
-    </para>
+    <varlistentry><term>index [required]</term>
+    <listitem>
+    <para>
+      The index of the part whose text length is to be retrieved.
+    </para>
+    </listitem></varlistentry>
+    <varlistentry><term>info [optional] [in / out]</term>
+    <listitem>
+    <para>
+      A <computeroutput>Directory</computeroutput> object in which the drawing technique can be retrieved. If
+      this argument is used, on return the object will contain these indexes:
+    </para>
+    <variablelist>
+      <varlistentry><term><emphasis role="bold">DRAWTYPE:</emphasis></term>
+      <listitem>
+      <para>
+        A key word that specifies the type of operation used to draw the text. This will be exactly one of the following
+        keywords:
+      </para>
+      <variablelist>
+        <varlistentry><term><emphasis role="bold">LOWERBORDERS</emphasis></term>
+        <listitem>
+        <para>
+          The text is drawn with a border to appear lower than the plane of the window.
+        </para>
+        </listitem></varlistentry>
+        <varlistentry><term><emphasis role="bold">NOBORDERS</emphasis></term>
+        <listitem>
+        <para>
+          The text is drawn without borders.
+        </para>
+        </listitem></varlistentry>
+        <varlistentry><term><emphasis role="bold">NOTABPARSING</emphasis></term>
+        <listitem>
+        <para>
+          Tab characters are ignored. See the <xref linkend="mthSetTextClsStatusBar"/> method for an explanation of how
+          embedded tabs are used in the text string.
+        </para>
+        </listitem></varlistentry>
+        <varlistentry><term><emphasis role="bold">OWNERDRAW</emphasis></term>
+        <listitem>
+        <para>
+          The text is drawn by the parent window. Owner draw is not currenly supported by the ooDialog framework.
+        </para>
+        </listitem></varlistentry>
+        <varlistentry><term><emphasis role="bold">POPOUT</emphasis></term>
+        <listitem>
+        <para>
+          The text is drawn with a border to appear higher than the plane of the window.
+        </para>
+        </listitem></varlistentry>
+        <varlistentry><term><emphasis role="bold">RTLREADING</emphasis></term>
+        <listitem>
+        <para>
+          The text will be displayed in the opposite direction to the text in the parent window.
+        </para>
+        </listitem></varlistentry>
+      </variablelist>
+      </listitem></varlistentry>
+      <varlistentry><term><emphasis role="bold">TEXTLENGTH:</emphasis></term>
+      <listitem>
+      <para>
+        The length of the text string for the part.
+      </para>
+      </listitem></varlistentry>
+    </variablelist>
     </listitem></varlistentry>
   </variablelist>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Return value:</emphasis></term>
   <listitem>
   <para>
-    xx
-  </para>
-  </listitem></varlistentry>
-  <varlistentry><term><emphasis role="bold">Remarks:</emphasis></term>
-  <listitem>
-  <para>
-    Additional comments.
+    The length of the text for the specified part, or -1 on error.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Details</emphasis></term>
   <listitem>
   <para>
     Raises syntax errors when incorrect usage is detected.
-  </para>
-  <para>
-    Sets the <link linkend="dotSystemErrorCode">.SystemErrorCode</link> variable.
-  </para>
-  </listitem></varlistentry>
-  <varlistentry><term><emphasis role="bold">Example:</emphasis></term>
-  <listitem>
-  <para>
-    This example ...
-<programlisting>
-<![CDATA[
-
-]]>
-</programlisting>
   </para>
   </listitem></varlistentry>
 </variablelist>
@@ -788,25 +866,24 @@
 <indexterm><primary>StatusBar class</primary><secondary>getTipText</secondary></indexterm>
 <programlisting>
 <![CDATA[
->>--getTipText(--+--------+--)---------------------------------------------><
-                  +--type--+
-]]>
-</programlisting>
-
-<para>
-  xx
+>>--getTipText(--index--)------------------------><
+]]>
+</programlisting>
+
+<para>
+  Retrieves the ToolTip text for the specified part in this status bar.
 </para>
 <variablelist>
   <varlistentry><term><emphasis role="bold">Arguments:</emphasis></term>
   <listitem>
   <para>
-    The arguments are:
+    The singke argument is:
   </para>
   <variablelist>
-    <varlistentry><term>TERM</term>
-    <listitem>
-    <para>
-      xx
+    <varlistentry><term>index [required]</term>
+    <listitem>
+    <para>
+      The one-based index of the part whose ToolTip text is to be retrieved.
     </para>
     </listitem></varlistentry>
   </variablelist>
@@ -814,33 +891,19 @@
   <varlistentry><term><emphasis role="bold">Return value:</emphasis></term>
   <listitem>
   <para>
-    xx
+    Returns the tool tip text on success, or the empty string if there is no tool tip text.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Remarks:</emphasis></term>
   <listitem>
   <para>
-    Additional comments.
+    Status bars must have the TOOLTIPS style to have tool tips.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Details</emphasis></term>
   <listitem>
   <para>
     Raises syntax errors when incorrect usage is detected.
-  </para>
-  <para>
-    Sets the <link linkend="dotSystemErrorCode">.SystemErrorCode</link> variable.
-  </para>
-  </listitem></varlistentry>
-  <varlistentry><term><emphasis role="bold">Example:</emphasis></term>
-  <listitem>
-  <para>
-    This example ...
-<programlisting>
-<![CDATA[
-
-]]>
-</programlisting>
   </para>
   </listitem></varlistentry>
 </variablelist>
@@ -851,39 +914,32 @@
 <indexterm><primary>StatusBar class</primary><secondary>isSimple</secondary></indexterm>
 <programlisting>
 <![CDATA[
->>--isSimple(--+--------+--)---------------------------------------------><
-                  +--type--+
-]]>
-</programlisting>
-
-<para>
-  xx
+>>--isSimple-------------------------------------><
+]]>
+</programlisting>
+
+<para>
+  Determines if this status bar is in <emphasis role="italic">simple</emphasis> mode.
 </para>
 <variablelist>
   <varlistentry><term><emphasis role="bold">Arguments:</emphasis></term>
   <listitem>
   <para>
-    The arguments are:
-  </para>
-  <variablelist>
-    <varlistentry><term>TERM</term>
-    <listitem>
-    <para>
-      xx
-    </para>
-    </listitem></varlistentry>
-  </variablelist>
+    This method has no arguments.
+  </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Return value:</emphasis></term>
   <listitem>
   <para>
-    xx
+    Returns true if this status bar is in simple mode, false if it is not.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Remarks:</emphasis></term>
   <listitem>
   <para>
-    Additional comments.
+    A status bar in simple mode displays only one part. In addition, when the text of the status bar is set, the operating
+    system use a technique to redraw the text that reduces flicker. The <xref linkend="mthSimple"/> method is used to switch
+    a status bar between modes.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Details</emphasis></term>
@@ -891,17 +947,27 @@
   <para>
     Raises syntax errors when incorrect usage is detected.
   </para>
-  <para>
-    Sets the <link linkend="dotSystemErrorCode">.SystemErrorCode</link> variable.
-  </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Example:</emphasis></term>
   <listitem>
   <para>
-    This example ...
-<programlisting>
-<![CDATA[
-
+    This example shows a code snippet that is used in an application that has a basic mode and an advanced mode. The code
+    snippet is used to toggle between the 2 modes:
+<programlisting>
+<![CDATA[
+  ...
+  sb = self~newStatusBar(IDC_STATUSBAR)
+
+  if sb~isSimple then do
+      self~statusBarUpdates = 'off'
+      self~setSimpleTasks
+      self~useWizrds = .true
+  end
+  else do
+      self~statusBarUpdates = 'on'
+      self~useAdavncedTasks
+      self~useWizrds = .false
+  end
 ]]>
 </programlisting>
   </para>
@@ -914,25 +980,26 @@
 <indexterm><primary>StatusBar class</primary><secondary>setBkColor</secondary></indexterm>
 <programlisting>
 <![CDATA[
->>--setBkColor(--+--------+--)---------------------------------------------><
-                  +--type--+
-]]>
-</programlisting>
-
-<para>
-  xx
+>>--setBkColor(--colorRef--)---------------------><
+]]>
+</programlisting>
+
+<para>
+  Sets the background color in this status bar.
 </para>
 <variablelist>
   <varlistentry><term><emphasis role="bold">Arguments:</emphasis></term>
   <listitem>
   <para>
-    The arguments are:
+    The single argument is:
   </para>
   <variablelist>
-    <varlistentry><term>TERM</term>
-    <listitem>
-    <para>
-      xx
+    <varlistentry><term>colorRef [required]</term>
+    <listitem>
+    <para>
+      A <xref linkend="defColorRef"/> value that specifies the new background color for the status bar. Use the <xref
+      linkend="mthColorRef"/> class method of the <xref linkend="clsImage"/> class to construct a proper COLORREF. Use
+      CLR_DEFAULT to set the background to the status bar's default color.
     </para>
     </listitem></varlistentry>
   </variablelist>
@@ -940,33 +1007,22 @@
   <varlistentry><term><emphasis role="bold">Return value:</emphasis></term>
   <listitem>
   <para>
-    xx
+    Returns the previous background color, or CLR_DEFAULT if the status bar was using its default color.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Remarks:</emphasis></term>
   <listitem>
   <para>
-    Additional comments.
+    Many dialog controls have a set background color API. However, when themes are turned on, it usually appears that the set
+    background color has no effect. Such is the case with the status bar control. Under most Windows 7 themes, the <emphasis
+    role="italic">setBkColor</emphasis> method appears to have no effect. That the method works can be seen by changing the
+    current theme to the Windows Classic them.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Details</emphasis></term>
   <listitem>
   <para>
     Raises syntax errors when incorrect usage is detected.
-  </para>
-  <para>
-    Sets the <link linkend="dotSystemErrorCode">.SystemErrorCode</link> variable.
-  </para>
-  </listitem></varlistentry>
-  <varlistentry><term><emphasis role="bold">Example:</emphasis></term>
-  <listitem>
-  <para>
-    This example ...
-<programlisting>
-<![CDATA[
-
-]]>
-</programlisting>
   </para>
   </listitem></varlistentry>
 </variablelist>
@@ -977,13 +1033,12 @@
 <indexterm><primary>StatusBar class</primary><secondary>setIcon</secondary></indexterm>
 <programlisting>
 <![CDATA[
->>--setIcon(--+--------+--)---------------------------------------------><
-                  +--type--+
-]]>
-</programlisting>
-
-<para>
-  xx
+>>--setIcon(--icon--,--index--)------------------><
+]]>
+</programlisting>
+
+<para>
+  Sets the icon for the specifie part in this status bar.
 </para>
 <variablelist>
   <varlistentry><term><emphasis role="bold">Arguments:</emphasis></term>
@@ -992,10 +1047,17 @@
     The arguments are:
   </para>
   <variablelist>
-    <varlistentry><term>TERM</term>
-    <listitem>
-    <para>
-      xx
+    <varlistentry><term>icon [required]</term>
+    <listitem>
+    <para>
+      The icon <xref linkend="clsImage"/> for the part, or the <computeroutput>.nil</computeroutput> object to remove the
+      current icon for the part.
+    </para>
+    </listitem></varlistentry>
+    <varlistentry><term>index [required]</term>
+    <listitem>
+    <para>
+      The one-based index of the part whose icon is being changed.
     </para>
     </listitem></varlistentry>
   </variablelist>
@@ -1003,13 +1065,16 @@
   <varlistentry><term><emphasis role="bold">Return value:</emphasis></term>
   <listitem>
   <para>
-    xx
+    Returns the old icon, or the <computeroutput>.nil</computeroutput> object if there was no existing icon, on success.
+    Returns -1 on error.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Remarks:</emphasis></term>
   <listitem>
   <para>
-    Additional comments.
+    Some dialog controls take ownership of image resources assigned to them and take care of releasing the resources. This is
+    not the case for the status bar. The ooDialog programmer is responsible for releasing the icon images when they are no
+    longer needed.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Details</emphasis></term>
@@ -1017,16 +1082,25 @@
   <para>
     Raises syntax errors when incorrect usage is detected.
   </para>
-  <para>
-    Sets the <link linkend="dotSystemErrorCode">.SystemErrorCode</link> variable.
-  </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Example:</emphasis></term>
   <listitem>
   <para>
-    This example ...
-<programlisting>
-<![CDATA[
+    This example shows a status bar with 4 parts. An image list is used with 4 icons in it. After loading the image list and
+    setting up the status bar, the first 4 icons in the image list are assigned to the 4 parts in the status bar:
+<programlisting>
+<![CDATA[
+::method initDialog
+    expose imageList status
+    ...
+    self~loadImageList
+    status = self~newStatusBar(IDC_STATUSBAR)
+    ...
+
+    do i = 1 to 4
+        icon = imageList~getIcon(i)
+        status~setIcon(icon, i)
+    end
 
 ]]>
 </programlisting>
@@ -1040,25 +1114,24 @@
 <indexterm><primary>StatusBar class</primary><secondary>setMinHeight</secondary></indexterm>
 <programlisting>
 <![CDATA[
->>--setMinHeight(--+--------+--)---------------------------------------------><
-                  +--type--+
-]]>
-</programlisting>
-
-<para>
-  xx
+>>--setMinHeight(--minHeight--)------------------><
+]]>
+</programlisting>
+
+<para>
+  Sets the minimum height of a status bar's drawing area.
 </para>
 <variablelist>
   <varlistentry><term><emphasis role="bold">Arguments:</emphasis></term>
   <listitem>
   <para>
-    The arguments are:
+    The single argument is:
   </para>
   <variablelist>
-    <varlistentry><term>TERM</term>
-    <listitem>
-    <para>
-      xx
+    <varlistentry><term>minHeight</term>
+    <listitem>
+    <para>
+      The minimum height, in pixels, that is desired.
     </para>
     </listitem></varlistentry>
   </variablelist>
@@ -1066,13 +1139,21 @@
   <varlistentry><term><emphasis role="bold">Return value:</emphasis></term>
   <listitem>
   <para>
-    xx
+    Returns 0, always.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Remarks:</emphasis></term>
   <listitem>
   <para>
-    Additional comments.
+    MSDN says the minimum height is set to: <emphasis role="italic">minHeight</emphasis> plus twice the width of the vertical
+    border. The <xref linkend="mthGetBorders"/> method can be used to get the width of the vertical border.
+  </para>
+  <para>
+    However, experimentation seems to show that the minimum height is actually set to: <emphasis
+    role="italic">minHeight</emphasis> plus 1 * the width of the vertical border. But MSDN is vague as to what exactly is
+    getting set. The doc says: <emphasis role="italic">minimum height of a status window's drawing area.</emphasis> The
+    drawing area of a window usually means the client area of a window. Testing shows that the client area height is set to
+    <emphasis role="italic">minHeight</emphasis> plus the width of the vertical border.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Details</emphasis></term>
@@ -1080,17 +1161,23 @@
   <para>
     Raises syntax errors when incorrect usage is detected.
   </para>
-  <para>
-    Sets the <link linkend="dotSystemErrorCode">.SystemErrorCode</link> variable.
-  </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Example:</emphasis></term>
   <listitem>
   <para>
-    This example ...
-<programlisting>
-<![CDATA[
-
+    In this example, the minimum height of the client area of the status bar is set to 28 pixels. The actual height was
+    verified using Spy++
+<programlisting>
+<![CDATA[
+  sb = self~newStatusBar(IDC_STATUS)
+
+  -- We want the minimum heigt to be 28 pixels.
+  min = 28
+  borders = sb~getBorders
+
+  min -= borders[2]
+
+  sb~setMinHeight(min)
 ]]>
 </programlisting>
   </para>
@@ -1103,39 +1190,41 @@
 <indexterm><primary>StatusBar class</primary><secondary>setParts</secondary></indexterm>
 <programlisting>
 <![CDATA[
->>--setParts(--+--------+--)---------------------------------------------><
-                  +--type--+
-]]>
-</programlisting>
-
-<para>
-  xx
+>>--setParts(--rightEdges--)---------------------><
+]]>
+</programlisting>
+
+<para>
+  Sets the number of parts in a status window and the width of each part.
 </para>
 <variablelist>
   <varlistentry><term><emphasis role="bold">Arguments:</emphasis></term>
   <listitem>
   <para>
-    The arguments are:
+    The single argument is:
   </para>
   <variablelist>
-    <varlistentry><term>TERM</term>
-    <listitem>
-    <para>
-      xx
-    </para>
-    </listitem></varlistentry>
-  </variablelist>
-  </listitem></varlistentry>
+    <varlistentry><term>rightEdges [required]</term>
+    <listitem>
+    <para>
+      An array of positive integers. Each integer specifies the right edge of a part in client <xref
+      linkend="defScreenCoordinates"/>, in pixels. The array can not be sparse. The number of items in the array will be the
+      number parts created. A -1 specifies the remaing area of the status bar.
+    </para>
+    </listitem></varlistentry>
+  </variablelist> </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Return value:</emphasis></term>
   <listitem>
   <para>
-    xx
+    True on success, false on error.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Remarks:</emphasis></term>
   <listitem>
   <para>
-    Additional comments.
+    It is important to note that the integers in the area represent the co-ordinate of the right edge of the part, not the
+    width of the part. A mistake the author often makes. For example, if a status bar has a width of 300, to divide it into 3
+    equal parts, use an array of 100, 200, -1. Not an array of 100, 100, -1.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Details</emphasis></term>
@@ -1143,17 +1232,19 @@
   <para>
     Raises syntax errors when incorrect usage is detected.
   </para>
-  <para>
-    Sets the <link linkend="dotSystemErrorCode">.SystemErrorCode</link> variable.
-  </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Example:</emphasis></term>
   <listitem>
   <para>
-    This example ...
-<programlisting>
-<![CDATA[
-
+    This example divides the status bar up into 4 parts. The first 3 parts are each 75 pixels in width and the fourth part
+    takes of the remainder of the status bar. Its width will be dependent on the width of the status bar. If the width of the
+    status bar was only 200 pixels, the fourth part would not show at all and the third part would only be 50 pixels wide:
+<programlisting>
+<![CDATA[
+    status = self~newStatusBar(IDC_STATUSBAR)
+
+    parts = .array~of(75, 150, 225, -1)
+    status~setParts(parts)
 ]]>
 </programlisting>
   </para>
@@ -1166,13 +1257,13 @@
 <indexterm><primary>StatusBar class</primary><secondary>setText</secondary></indexterm>
 <programlisting>
 <![CDATA[
->>--setText(--+--------+--)---------------------------------------------><
-                  +--type--+
-]]>
-</programlisting>
-
-<para>
-  xx
+>>--setText(--text--,--index--+-------------+--)----------------><
+                              +-,-drawType--+
+]]>
+</programlisting>
+
+<para>
+  Sets the text for the specified part.
 </para>
 <variablelist>
   <varlistentry><term><emphasis role="bold">Arguments:</emphasis></term>
@@ -1181,24 +1272,77 @@
     The arguments are:
   </para>
   <variablelist>
-    <varlistentry><term>TERM</term>
-    <listitem>
-    <para>
-      xx
-    </para>
+    <varlistentry><term>text [required]</term>
+    <listitem>
+    <para>
+      The text for the part.
+    </para>
+    </listitem></varlistentry>
+    <varlistentry><term>index [required]</term>
+    <listitem>
+    <para>
+      The one-based index of the part whose text is to be set.
+    </para>
+    </listitem></varlistentry>
+    <varlistentry><term>drawType [optional]</term>
+    <listitem>
+    <para>
+      A single keyword that specifies the drawing technique used by the control to draw the text. The following keywords are
+      accepted, case is not significant:
+    </para>
+    <variablelist>
+      <varlistentry><term><emphasis role="bold">LOWERBORDERS</emphasis></term>
+      <listitem>
+      <para>
+        The text is drawn with a border to appear lower than the plane of the window. This is the default if the <emphasis
+        role="italic">drawType</emphasis> argument is omitted.
+      </para>
+      </listitem></varlistentry>
+      <varlistentry><term><emphasis role="bold">NOBORDERS</emphasis></term>
+      <listitem>
+      <para>
+        The text is drawn without borders.
+      </para>
+      </listitem></varlistentry>
+      <varlistentry><term><emphasis role="bold">NOTABPARSING</emphasis></term>
+      <listitem>
+      <para>
+        Tab characters are ignored. See the <emphasis role="italic">Remarks</emphasis> section.
+      </para>
+      </listitem></varlistentry>
+      <varlistentry><term><emphasis role="bold">OWNERDRAW</emphasis></term>
+      <listitem>
+      <para>
+        The text is drawn by the parent window. Owner draw is not currenly well supported by the ooDialog framework.
+      </para>
+      </listitem></varlistentry>
+      <varlistentry><term><emphasis role="bold">POPOUT</emphasis></term>
+      <listitem>
+      <para>
+        The text is drawn with a border to appear higher than the plane of the window.
+      </para>
+      </listitem></varlistentry>
+      <varlistentry><term><emphasis role="bold">RTLREADING</emphasis></term>
+      <listitem>
+      <para>
+        The text will be displayed in the opposite direction to the text in the parent window.
+      </para>
+      </listitem></varlistentry>
+    </variablelist>
     </listitem></varlistentry>
   </variablelist>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Return value:</emphasis></term>
   <listitem>
   <para>
-    xx
+    Returns true on success, false on error.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Remarks:</emphasis></term>
   <listitem>
   <para>
-    Additional comments.
+    By default text is left-aligned. This can be changed by embedding tab characters in the text. Text to the right of a
+    single tab character is center-aligned. Text to the right of 2 tab characters is right-aligned.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Details</emphasis></term>
@@ -1206,17 +1350,21 @@
   <para>
     Raises syntax errors when incorrect usage is detected.
   </para>
-  <para>
-    Sets the <link linkend="dotSystemErrorCode">.SystemErrorCode</link> variable.
-  </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Example:</emphasis></term>
   <listitem>
   <para>
-    This example ...
-<programlisting>
-<![CDATA[
-
+    This example divides a status bar into 4 parts and then sets the text for the parts
+<programlisting>
+<![CDATA[
+  status = self~newStatusBar(IDC_STATUSBAR)
+
+  parts = .array~of(75, 150, 225, -1)
+  status~setParts(parts)
+  status~setText("Friday", 1, 'POPOUT')
+  status~setText("January", 2, 'POPOUT')
+  status~setText("22nd", 3)
+  status~setText("Viking Victory", 4)
 ]]>
 </programlisting>
   </para>
@@ -1229,13 +1377,12 @@
 <indexterm><primary>StatusBar class</primary><secondary>setTipText</secondary></indexterm>
 <programlisting>
 <![CDATA[
->>--setTipText(--+--------+--)---------------------------------------------><
-                  +--type--+
-]]>
-</programlisting>
-
-<para>
-  xx
+>>--setTipText(--text--,--index--)---------------><
+]]>
+</programlisting>
+
+<para>
+  Sets the ToolTip text for a part in a status bar.
 </para>
 <variablelist>
   <varlistentry><term><emphasis role="bold">Arguments:</emphasis></term>
@@ -1244,10 +1391,16 @@
     The arguments are:
   </para>
   <variablelist>
-    <varlistentry><term>TERM</term>
-    <listitem>
-    <para>
-      xx
+    <varlistentry><term>text [required]</term>
+    <listitem>
+    <para>
+      The text of the tool tip.
+    </para>
+    </listitem></varlistentry>
+    <varlistentry><term>index [required]</term>
+    <listitem>
+    <para>
+      The one-base index of the part whose tool tip is being set.
     </para>
     </listitem></varlistentry>
   </variablelist>
@@ -1255,31 +1408,59 @@
   <varlistentry><term><emphasis role="bold">Return value:</emphasis></term>
   <listitem>
   <para>
-    xx
+    Returns 0, always.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Remarks:</emphasis></term>
   <listitem>
   <para>
-    Additional comments.
-  </para>
+    The length of <emphasis role="italic">text</emphasis> can not be longer than 511. The status bar must have the TOOLTIPS
+    style to display a tool tip. The tool tip is only displayed under these circumstances:
+  </para>
+  <itemizedlist>
+  <listitem>
+  <para>
+    When the corresponding part in the status bar contains only an icon.
+  </para>
+  </listitem>
+  <listitem>
+  <para>
+    When the corresponding pane in the status bar contains text that is truncated due to the size of the pane.
+  </para>
+  </listitem>
+  </itemizedlist>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Details</emphasis></term>
   <listitem>
   <para>
     Raises syntax errors when incorrect usage is detected.
   </para>
-  <para>
-    Sets the <link linkend="dotSystemErrorCode">.SystemErrorCode</link> variable.
-  </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Example:</emphasis></term>
   <listitem>
   <para>
-    This example ...
-<programlisting>
-<![CDATA[
-
+    This example divides a status bar up into 4 parts. Since the first 3 parts are not wide enough to display the entire text
+    string, a tool tip is added for each of them:
+<programlisting>
+<![CDATA[
+    status = self~newStatusBar(IDC_STATUSBAR)
+
+    parts = .array~of(75, 150, 225, -1)
+    status~setParts(parts)
+
+    text = "Thank God it is Friday"
+    status~setText(text, 1, 'POPOUT')
+    status~setTipText(text, 1)
+
+    text = "January in northen Canada"
+    status~setText(text, 2, 'POPOUT')
+    status~setTipText(text, 2)
+
+    text = "The 22nd Bomber Squadron"
+    status~setText(text, 3)
+    status~setTipText(text, 3)
+
+    status~setText("Viking Victory", 4)
 ]]>
 </programlisting>
   </para>
@@ -1292,25 +1473,27 @@
 <indexterm><primary>StatusBar class</primary><secondary>simple</secondary></indexterm>
 <programlisting>
 <![CDATA[
->>--simple(--+--------+--)---------------------------------------------><
-                  +--type--+
-]]>
-</programlisting>
-
-<para>
-  xx
+>>--simple(--+---------+--)----------------------><
+             +--onOff--+
+]]>
+</programlisting>
+
+<para>
+  Specifies whether a status window displays simple text or displays all window parts set by a previous <xref
+  linkend="mthSetParts"/> method.
 </para>
 <variablelist>
   <varlistentry><term><emphasis role="bold">Arguments:</emphasis></term>
   <listitem>
   <para>
-    The arguments are:
+    The single argument is:
   </para>
   <variablelist>
-    <varlistentry><term>TERM</term>
-    <listitem>
-    <para>
-      xx
+    <varlistentry><term>onOff [optional]</term>
+    <listitem>
+    <para>
+      True to put the status bar in simple mode, false to take it out of simple mode. The default if the argument is omitted
+      is true.
     </para>
     </listitem></varlistentry>
   </variablelist>
@@ -1318,13 +1501,17 @@
   <varlistentry><term><emphasis role="bold">Return value:</emphasis></term>
   <listitem>
   <para>
-    xx
+    Returns 0, always.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Remarks:</emphasis></term>
   <listitem>
   <para>
-    Additional comments.
+    A status bar in simple mode displays only one part. In addition, when the text of the status bar is set, the operating
+    system use a technique to redraw the text that reduces flicker. The <xref linkend="mthIsSimple"/> method can be used to
+    test what mode the status bar is currently in. In addition the <xref linkend="kywStatusBarSIMPLEMODECHANGE"/> event can
+    be connected for the statust bar. The event handler will be invoked each time the status bar mode swtiches to or from
+    simple.
   </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Details</emphasis></term>
@@ -1332,17 +1519,19 @@
   <para>
     Raises syntax errors when incorrect usage is detected.
   </para>
-  <para>
-    Sets the <link linkend="dotSystemErrorCode">.SystemErrorCode</link> variable.
-  </para>
   </listitem></varlistentry>
   <varlistentry><term><emphasis role="bold">Example:</emphasis></term>
   <listitem>
   <para>
-    This example ...
-<programlisting>
-<![CDATA[
-
+    This simple code snippet merely toggles the simple mode each time it is executed:
+<programlisting>
+<![CDATA[
+    if sb~isSimple then do
+      sb~simple(.false)
+    end
+    else do
+      sb~simple(.true)
+    end
 ]]>
 </programlisting>
   </para>