Added mostly empty wxLaunchDefaultApplication

[wxWidgets.git] / interface / recguard.h

diff --git a/interface/recguard.h b/interface/recguard.h
index e5c3a367c8377faa11849fed1411f9b34c9e9aa2..d646798f41b46da40f8d0797af807ae05e37eb15 100644 (file)
--- a/interface/recguard.h
+++ b/interface/recguard.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        recguard.h
 /////////////////////////////////////////////////////////////////////////////
 // Name:        recguard.h

-// Purpose:     documentation for wxRecursionGuardFlag class
+// Purpose:     interface of wxRecursionGuardFlag

 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license


@@ -11,14 +11,15 @@
     @wxheader{recguard.h}
 
     This is a completely opaque class which exists only to be used with
     @wxheader{recguard.h}
 
     This is a completely opaque class which exists only to be used with

-    wxRecursionGuard, please see the example in that
-    class documentation.
+    wxRecursionGuard, please see the example in that class' documentation.

 
 

-    Please notice that wxRecursionGuardFlag object must be declared
-    @c static or the recursion would never be detected.
+    @remarks
+
+    wxRecursionGuardFlag object must be declared @c static or the recursion
+    would never be detected.

 
     @library{wxbase}
 
     @library{wxbase}

-    @category{FIXME}
+    @category{misc}

 */
 class wxRecursionGuardFlag
 {
 */
 class wxRecursionGuardFlag
 {


@@ -27,6 +28,7 @@ public:
 };
 
 
 };
 
 

+

 /**
     @class wxRecursionGuard
     @wxheader{recguard.h}
 /**
     @class wxRecursionGuard
     @wxheader{recguard.h}


@@ -41,35 +43,35 @@ public:
 
     @code
     void Foo()
 
     @code
     void Foo()

+    {
+        static wxRecursionGuardFlag s_flag;
+        wxRecursionGuard guard(s_flag);
+        if ( guard.IsInside() )

         {
         {

-            static wxRecursionGuardFlag s_flag;
-            wxRecursionGuard guard(s_flag);
-            if ( guard.IsInside() )
-            {
-                // don't allow reentrancy
-                return;
-            }
-
-            ...
+            // don't allow reentrancy
+            return;

         }
         }

+
+        ...
+    }

     @endcode
 
     As you can see, wxRecursionGuard simply tests the flag value and sets it to
     @true if it hadn't been already set.
     @endcode
 
     As you can see, wxRecursionGuard simply tests the flag value and sets it to
     @true if it hadn't been already set.

-    wxRecursionGuard::IsInside allows testing the old flag
+    IsInside() allows testing the old flag

     value. The advantage of using this class compared to directly manipulating the
     flag is that the flag is always reset in the wxRecursionGuard destructor and so
     you don't risk to forget to do it even if the function returns in an unexpected
     way (for example because an exception has been thrown).
 
     @library{wxbase}
     value. The advantage of using this class compared to directly manipulating the
     flag is that the flag is always reset in the wxRecursionGuard destructor and so
     you don't risk to forget to do it even if the function returns in an unexpected
     way (for example because an exception has been thrown).
 
     @library{wxbase}

-    @category{FIXME}
+    @category{misc}

 */
 class wxRecursionGuard
 {
 public:
     /**
 */
 class wxRecursionGuard
 {
 public:
     /**

-        A wxRecursionGuard object must always be initialized with a (static)
+        A wxRecursionGuard object must always be initialized with a @c static

         wxRecursionGuardFlag. The constructor saves the
         value of the flag to be able to return the correct value from
         IsInside().
         wxRecursionGuardFlag. The constructor saves the
         value of the flag to be able to return the correct value from
         IsInside().


@@ -79,17 +81,20 @@ public:
     /**
         The destructor resets the flag value so that the function can be entered again
         the next time.
     /**
         The destructor resets the flag value so that the function can be entered again
         the next time.

-        Note that it is not virtual and so this class is not meant to be derived from
-        (besides, there is absolutely no reason to do it anyhow).
+
+        @note This is not virtual, so this class is not meant to be derived
+              from (besides, there is absolutely no reason to do it anyhow).

     */
     ~wxRecursionGuard();
 
     /**
     */
     ~wxRecursionGuard();
 
     /**

-        Returns @true if we're already inside the code block "protected'' by this
-        wxRecursionGuard (i.e. between this line and the end of current scope). Usually
-        the function using wxRecursionGuard takes some specific actions in such case
-        (may be simply returning) to prevent reentrant calls to itself.
+        Returns @true if we're already inside the code block "protected" by this
+        wxRecursionGuard (i.e. between this line and the end of current scope).
+        Usually the function using wxRecursionGuard takes some specific actions
+        in such case (may be simply returning) to prevent reentrant calls to itself.
+

         If this method returns @false, it is safe to continue.
     */
         If this method returns @false, it is safe to continue.
     */

-    bool IsInside();
+    bool IsInside() const;

 };
 };

+