Correct introduction to wxControlWithItems

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@53103 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

diff --git a/interface/ctrlsub.h b/interface/ctrlsub.h
index 9376be9a86a29a1bcb81221db9f359f1163a617a..3ac1b3a4528e3a00332cc63e194f4a537cb65ee1 100644 (file)
--- a/interface/ctrlsub.h
+++ b/interface/ctrlsub.h
@@ -11,9 +11,9 @@
     @wxheader{ctrlsub.h}
 
     This class is an abstract base class for some wxWidgets controls which contain
     @wxheader{ctrlsub.h}
 
     This class is an abstract base class for some wxWidgets controls which contain

-    several items, such as wxListBox and
-    wxCheckListBox derived from it,
-    wxChoice and wxComboBox.
+    several items such as wxListBox, wxCheckListBox, wxChoice and wxComboBox derive
+    from it.
+    

 
     It defines the methods for accessing the controls items and although each of
     the derived classes implements them differently, they still all conform to the
 
     It defines the methods for accessing the controls items and although each of
     the derived classes implements them differently, they still all conform to the


@@ -24,16 +24,18 @@
     different kinds: either simple untyped (@c void *) pointers which are simply
     stored by the control but not used in any way by it, or typed pointers
     (@c wxClientData *) which are owned by the control meaning that the typed
     different kinds: either simple untyped (@c void *) pointers which are simply
     stored by the control but not used in any way by it, or typed pointers
     (@c wxClientData *) which are owned by the control meaning that the typed

-    client data (and only it) will be deleted when an item is
-    @ref wxControlWithItems::delete deleted or the entire control is
-    @ref wxControlWithItems::clear cleared (which also happens when it is
-    destroyed). Finally note that in the same control all items must have client
-    data of the same type (typed or untyped), if any. This type is determined by
+    client data (and only it) will be deleted when an item is deleted
+    (using wxControlWithItems::Delete) or the entire control is cleared
+    (using wxControlWithItems::Clear) which also happens when it is
+    destroyed. 
+    
+    Finally note that in the same control all items must have client data of the
+    same type (typed or untyped), if any. This type is determined by

     the first call to wxControlWithItems::Append (the version with
     client data pointer) or wxControlWithItems::SetClientData.
 
     @library{wxcore}
     the first call to wxControlWithItems::Append (the version with
     client data pointer) or wxControlWithItems::SetClientData.
 
     @library{wxcore}

-    @category{FIXME}
+    @category{controls}

 
     @see wxControlWithItems::Clear
 */
 
     @see wxControlWithItems::Clear
 */