proofread CH03.xml

1 files changed, 76 insertions, 61 deletions

diff --git a/specs/CH03.xml b/specs/CH03.xml
index dc0bdfa..59fe18f 100644
--- a/specs/CH03.xml
+++ b/specs/CH03.xml
@@ -97,9 +97,7 @@ should appear within the composite widget's window.
 Geometry management techniques fall into four classes:
 <variablelist>
   <varlistentry>
-    <term>
-      "Fixed
-    </term>
+    <term>Fixed boxes</term>
     <listitem>
       <para>
 Fixed boxes have a fixed number of children created by the parent.
@@ -109,9 +107,7 @@ and none ever makes geometry manager requests.
     </listitem>
   </varlistentry>
   <varlistentry>
-    <term>
-      "Homogeneous
-    </term>
+    <term>Homogeneous boxes</term>
     <listitem>
       <para>
 Homogeneous boxes treat all children equally and apply the same geometry
@@ -121,9 +117,7 @@ Many clients insert and delete widgets freely.
     </listitem>
   </varlistentry>
   <varlistentry>
-    <term>
-      "Heterogeneous
-    </term>
+    <term>Heterogeneous boxes</term>
     <listitem>
       <para>
 Heterogeneous boxes have a specific location where each child is placed.
@@ -137,9 +131,7 @@ Constraint.
     </listitem>
   </varlistentry>
   <varlistentry>
-    <term>
-      "Shell
-    </term>
+    <term>Shell boxes</term>
     <listitem>
       <para>
 Shell boxes typically have only one child,
@@ -246,7 +238,7 @@ The insert_position procedure pointer in a composite widget instance is of type
 
 <funcsynopsis id='XtOrderProc'>
 <funcprototype>
-<funcdef>Cardinal <function>*XtOrderProc</function></funcdef>
+<funcdef>typedef Cardinal <function>(*XtOrderProc)</function></funcdef>
 
    <paramdef>Widget <parameter>w</parameter></paramdef>
 </funcprototype>
@@ -299,18 +291,24 @@ The delete_child procedure pointer is of type
 
 <funcsynopsis id='_XtWidgetProc'>
 <funcprototype>
-<funcdef>void <function>*XtWidgetProc</function></funcdef>
+<funcdef>typedef void <function>(*XtWidgetProc)</function></funcdef>
    <paramdef>Widget <parameter>w</parameter></paramdef>
 </funcprototype>
 </funcsynopsis>
 
-<itemizedlist>
-  <listitem>
-    <para>
+<variablelist>
+  <varlistentry>
+    <term>
+      <emphasis remap='I'>w</emphasis>
+    </term>
+    <listitem>
+      <para>
 Passes the child being deleted.
-    </para>
-  </listitem>
-</itemizedlist>
+      </para>
+    </listitem>
+  </varlistentry>
+</variablelist>
+
 <para>
 Most widgets inherit the delete_child procedure from their superclass.
 Composite widgets that create companion widgets define their own
@@ -340,9 +338,10 @@ subset of their Composite parent, use
 </para>
 
 <para>typedef Widget *WidgetList;</para>
+
 <funcsynopsis id='XtManageChildren'>
 <funcprototype>
-<funcdef> <function>XtManageChildren</function></funcdef>
+<funcdef>void <function>XtManageChildren</function></funcdef>
    <paramdef>WidgetList <parameter>children</parameter></paramdef>
    <paramdef>Cardinal <parameter>num_children</parameter></paramdef>
 </funcprototype>
@@ -400,22 +399,26 @@ it makes some of the newly managed children viewable:
     </para>
   </listitem>
   <listitem>
-    <para>
+    <itemizedlist>
+      <listitem>
+        <para>
 Calls the change_managed routine of the widgets' parent.
-    </para>
-  </listitem>
-  <listitem>
-    <para>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
 Calls
 <function>XtRealizeWidget</function>
 on each previously unmanaged child that is unrealized.
-    </para>
-  </listitem>
-  <listitem>
-    <para>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
 Maps each previously unmanaged child that has <emphasis remap='I'>map_when_managed</emphasis>
 <function>True</function>.
-    </para>
+        </para>
+      </listitem>
+    </itemizedlist>
   </listitem>
 </itemizedlist>
 <para>
@@ -693,16 +696,20 @@ ignores the child if it is unmanaged; otherwise it performs the following:
     </para>
   </listitem>
   <listitem>
-    <para>
+    <itemizedlist>
+      <listitem>
+        <para>
 Marks the child as unmanaged.
-    </para>
-  </listitem>
-  <listitem>
-    <para>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
 If the child is realized and the <emphasis remap='I'>map_when_managed</emphasis> field is
 <function>True</function>,
 it is unmapped.
-    </para>
+        </para>
+      </listitem>
+    </itemizedlist>
   </listitem>
   <listitem>
     <para>
@@ -893,23 +900,27 @@ performs the following:
     </para>
   </listitem>
   <listitem>
-    <para>
+    <itemizedlist>
+      <listitem>
+        <para>
 Calls
 <function>XtUnmanageChildren</function>
 (<emphasis remap='I'>unmanage_children</emphasis>, <emphasis remap='I'>num_unmanage_children</emphasis>).
-    </para>
-  </listitem>
-  <listitem>
+        </para>
+      </listitem>
+      <listitem>
     <para>
 Calls the <emphasis remap='I'>do_change_proc</emphasis>.
-    </para>
-  </listitem>
-  <listitem>
-    <para>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
 Calls
 <function>XtManageChildren</function>
 (<emphasis remap='I'>manage_children</emphasis>, <emphasis remap='I'>num_manage_children</emphasis>).
-    </para>
+        </para>
+      </listitem>
+    </itemizedlist>
   </listitem>
   <listitem>
     <para>
@@ -917,28 +928,30 @@ Otherwise, the following is performed:
     </para>
   </listitem>
   <listitem>
-    <para>
+    <itemizedlist>
+      <listitem>
+        <para>
 For each child on the <emphasis remap='I'>unmanage_children</emphasis> list; if the child is
 already unmanaged it is ignored, otherwise it is marked as unmanaged,
 and if it is realized and its <emphasis remap='I'>map_when_managed</emphasis> field is
 <function>True</function>,
 it is unmapped.
-    </para>
-  </listitem>
-  <listitem>
-    <para>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
 If <emphasis remap='I'>do_change_proc</emphasis> is non-NULL, the procedure is invoked.
-    </para>
-  </listitem>
-  <listitem>
-    <para>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
 For each child on the <emphasis remap='I'>manage_children</emphasis> list; if the child is already
 managed or is being destroyed, it is ignored; otherwise it is
 marked as managed.
-    </para>
-  </listitem>
-  <listitem>
-    <para>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
 If the parent is realized and after all children have been marked,
 the change_managed method of the parent is invoked, and subsequently
 some of the newly managed children are made viewable by calling
@@ -946,7 +959,9 @@ some of the newly managed children are made viewable by calling
 on each previously unmanaged child that is unrealized and
 mapping each previously unmanaged child that has <emphasis remap='I'>map_when_managed</emphasis>
 <function>True</function>.
-    </para>
+        </para>
+      </listitem>
+    </itemizedlist>
   </listitem>
 </itemizedlist>
 <para>
@@ -979,7 +994,7 @@ The <emphasis remap='I'>do_change_proc</emphasis> is of type
 
 <funcsynopsis id='XtDoChangeProc'>
 <funcprototype>
-<funcdef>void <function>*XtDoChangeProc</function></funcdef>
+<funcdef>typedef void <function>*XtDoChangeProc</function></funcdef>
 
    <paramdef>Widget <parameter>composite_parent</parameter></paramdef>
    <paramdef>WidgetList <parameter>unmange_children</parameter></paramdef>