Add missing critical section locking before accessing shared variable.

[wxWidgets.git] / docs / doxygen / overviews / windowids.h

diff --git a/docs/doxygen/overviews/windowids.h b/docs/doxygen/overviews/windowids.h
index 989f6002ee6986a955d9905656e11b23033be524..169383f4736a7507713450d29f98cbbddf2a81b3 100644 (file)
--- a/docs/doxygen/overviews/windowids.h
+++ b/docs/doxygen/overviews/windowids.h
@@ -3,40 +3,26 @@
 // Purpose:     topic overview
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 /**
 
 @page overview_windowids Window IDs
 
-@li @ref overview_windowids_intro
-@li @ref overview_windowids_type
-@li @ref overview_windowids_using
+@tableofcontents
 
-@see
-
-@li wxIdManager
-@li wxWindow::NewControlId
-@li wxWindow::UnreserveControlId
-
-
-<hr>
-
-
-@section overview_windowids_intro Introduction
-
-Various contols and other parts of wxWidgets need an ID.  Sometimes the ID may
-be directly provided by the use or have a predefined value, such as
+Various controls and other parts of wxWidgets need an ID.  Sometimes the ID may
+be directly provided by the user or have a predefined value, such as
 @c wxID_OPEN. Often, however, the value of the ID is unimportant and is created
 automatically by calling wxWindow::NewControlId or by passing @c wxID_ANY as
 the ID of an object.
 
-There are two ways to generate an ID.  One way, is to start at a negative
+There are two ways to generate an ID.  One way is to start at a negative
 number, and for each new ID, return the next smallest number.  This is fine for
-systems that can used the full range of negative numbers for an ID, as this
+systems that can use the full range of negative numbers for IDs, as this
 provides more than enough IDs and it would take a very very long time to run
-out and wrap around.  However, some systems can not use the full range of the
+out and wrap around.  However, some systems cannot use the full range of the
 ID value. Windows, for example, can only use 16 bit IDs, and only has about
 32000 possible automatic IDs that can be generated by wxWindow::NewControlId.
 If the program runs long enough, depending on the program itself, using this
@@ -50,6 +36,8 @@ one another.  This is accomplished by keeping a reference count for each of the
 IDs that can possibly be returned by wxWindow::NewControlId. Other IDs are not
 reference counted.
 
+@see wxIdManager, wxWindow::NewControlId(), wxWindow::UnreserveControlId()
+
 
 @section overview_windowids_type Data Types
 
@@ -70,8 +58,8 @@ it is assigned to a wxWindowIDRef, then it will be unreserved automatically and
 will be considered free when the count is 0, and should NOT be manually
 unreserved.
 
-wxWindowIDRef can store both automatic IDs from wxWindow::NewControlId as well
-as normal IDs.  Reference counting is only done for the automatic IDs.  Also,
+wxWindowIDRef can store both automatic IDs from wxWindow::NewControlId and
+normal IDs.  Reference counting is only done for the automatic IDs.  Also,
 wxWindowIDRef has conversion operators that allow it to be treated just like a
 wxWindowID.
 
@@ -85,4 +73,3 @@ This is done already for windows, menu items, and tool bar items. It should
 only be used in the main thread, as it is not thread safe.
 
 */
-