first revision (contains wxHelpEvent and wxNavigationKeyEvent modifications which...

[wxWidgets.git] / interface / init.h

diff --git a/interface/init.h b/interface/init.h
index d0c074994279f0aef4bb97a6e86f2fd3b7a73905..499dbe1eed9235ebc54479ad1122d98ee9aebd9a 100644 (file)
--- a/interface/init.h
+++ b/interface/init.h
@@ -1,27 +1,53 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        init.h
 /////////////////////////////////////////////////////////////////////////////
 // Name:        init.h

-// Purpose:     documentation for global functions
+// Purpose:     interface of global functions

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

+/** @ingroup group_funcmacro_appinitterm */
+//@{
+

 /**
 /**

-Free resources allocated by a successful call to wxEntryStart.
-*/
-void wxEntryCleanup();
+    This function can be used to perform the initialization of wxWidgets if you
+    can't use the default initialization code for any reason.

 
 

+    If the function returns true, the initialization was successful and the
+    global wxApp object ::wxTheApp has been created. Moreover, wxEntryCleanup()
+    must be called afterwards. If the function returns false, a catastrophic
+    initialization error occured and (at least the GUI part of) the library
+    can't be used at all.
+
+    Notice that parameters @c argc and @c argv may be modified by this
+    function.
+
+    @header{wx/init.h}
+*/
+bool wxEntryStart(int& argc, wxChar** argv);

 
 

-//@{

 /**
 /**

-    (notice that under Windows CE platform, and only there, the type of
-    @e pCmdLine is @c wchar_t *, otherwise it is @c char *, even in
-    Unicode build).
+    See wxEntryStart(int&,wxChar**) for more info about this function.
+
+    This is an additional overload of wxEntryStart() provided under MSW only.
+    It is meant to be called with the parameters passed to WinMain().
+
+    @note Under Windows CE platform, and only there, the type of @a pCmdLine is
+    @c wchar_t *, otherwise it is @c char *, even in Unicode build.
+
+    @header{wx/init.h}

 */
 */

-bool wxEntryStart(int& argc, wxChar ** argv);

 bool wxEntryStart(HINSTANCE hInstance,
 bool wxEntryStart(HINSTANCE hInstance,

-                  HINSTANCE hPrevInstance = @NULL,
-                  char * pCmdLine = @NULL,
+                  HINSTANCE hPrevInstance = NULL,
+                  char* pCmdLine = NULL,

                   int nCmdShow = SW_SHOWNORMAL);
                   int nCmdShow = SW_SHOWNORMAL);

+
+/**
+    Free resources allocated by a successful call to wxEntryStart().
+
+    @header{wx/init.h}
+*/
+void wxEntryCleanup();
+

 //@}
 
 //@}