Updated 'create_thread' function comments.

[nit.git] / lib / pnacl.nit

diff --git a/lib/pnacl.nit b/lib/pnacl.nit
index 3216b73..42a6b8c 100644 (file)
--- a/lib/pnacl.nit
+++ b/lib/pnacl.nit
@@ -712,14 +712,34 @@ class PnaclApp
 
        # Checks if there is a dictionary in the queue, and if so the dictionary is handled automatically.
        fun check_dictionary `{
-               while(1) {
-                       NitHandleDictionary();
-               }
+               NitHandleDictionary();
        `}
+
+       # Infinite loop on check_dictionary
+       fun run
+       do
+               loop
+                       check_dictionary
+               end
+       end
 end
 
 redef interface Object
-       # Calls 'pthread_exit on current thread
+       # Creates a new thread for Nit.
+       #
+       # This function launches the Nit main on a new thread.
+       # Its purpose is to allow Nit to be still operational after an exit when needed,
+       # because reloading the page may not be an option.
+       #
+       # Should only be used within the 'exit' before stopping the current thread
+       # when the Nit execution causes a crash.
+       #
+       # REQUIRE: g_nit_thread and WrapperNitMain are set.
+       fun create_thread `{
+               pthread_create(&g_nit_thread, NULL, &WrapperNitMain, NULL);
+       `}
+
+       # Calls 'pthread_exit on current thread.
         fun exit_thread(exit_value: Int) `{
                pthread_exit((void*) exit_value);
        `}