Browse Source

Improve the Handling quit requests page

Hugo Locurcio 5 years ago
parent
commit
fdac2a6db5
1 changed files with 15 additions and 5 deletions
  1. 15 5
      tutorials/misc/handling_quit_requests.rst

+ 15 - 5
tutorials/misc/handling_quit_requests.rst

@@ -7,18 +7,28 @@ Quitting
 --------
 
 Most platforms have the option to request the application to quit. On
-desktops, this is usually done with the "x" icon on the window titlebar.
+desktops, this is usually done with the "x" icon on the window title bar.
 On Android, the back button is used to quit when on the main screen (and
 to go back otherwise).
 
 Handling the notification
 -------------------------
 
-The :ref:`MainLoop <class_MainLoop>`
-has a special notification that is sent to all nodes when quit is
-requested: MainLoop.NOTIFICATION_WM_QUIT.
+On desktop platforms, the :ref:`MainLoop <class_MainLoop>`
+has a special ``MainLoop.NOTIFICATION_WM_QUIT_REQUEST`` notification that is
+sent to all nodes when quitting is requested.
 
-Handling it is done as follows (on any node):
+On Android, ``MainLoop.NOTIFICATION_WM_GO_BACK_REQUEST`` is sent instead.
+Pressing the Back button will exit the application if
+**Application > Config > Quit On Go Back** is checked in the Project Settings
+(which is the default).
+
+.. note::
+
+    ``MainLoop.NOTIFICATION_WM_GO_BACK_REQUEST`` isn't supported on iOS, as
+    iOS devices don't have a physical Back button.
+
+Handling the notification is done as follows (on any node):
 
 .. tabs::
  .. code-tab:: gdscript GDScript