classref: Sync with current master branch (9723077)

classes/class_animatedtexture.rst

@@ -27,7 +27,9 @@ The playback of the animation is controlled by the :ref:`speed_scale<class_Anima
 
 \ **Note:** AnimatedTexture doesn't support using :ref:`AtlasTexture<class_AtlasTexture>`\ s. Each frame needs to be a separate :ref:`Texture2D<class_Texture2D>`.
 
-\ **Warning:** AnimatedTexture is deprecated, and might be removed in a future release. Its current implementation is not efficient for the modern renderers.
+\ **Warning:** The current implementation is not efficient for the modern renderers.
+
+\ *Deprecated.* This class is deprecated, and might be removed in a future release.
 
 .. rst-class:: classref-reftable-group
 

classes/class_astargrid2d.rst

@@ -389,7 +389,7 @@ The region of grid cells available for pathfinding. If changed, :ref:`update<cla
 
 The size of the grid (number of cells of size :ref:`cell_size<class_AStarGrid2D_property_cell_size>` on each axis). If changed, :ref:`update<class_AStarGrid2D_method_update>` needs to be called before finding the next path.
 
-\ **Note:** This property is deprecated, use :ref:`region<class_AStarGrid2D_property_region>` instead.
+\ *Deprecated.* Use :ref:`region<class_AStarGrid2D_property_region>` instead.
 
 .. rst-class:: classref-section-separator
 

classes/class_control.rst

@@ -1743,7 +1743,7 @@ The size of the node's bounding rectangle, in the node's coordinate system. :ref
 - void **set_h_size_flags** **(** :ref:`SizeFlags<enum_Control_SizeFlags>` value **)**
 - :ref:`SizeFlags<enum_Control_SizeFlags>` **get_h_size_flags** **(** **)**
 
-Tells the parent :ref:`Container<class_Container>` nodes how they should resize and place the node on the X axis. Use one of the :ref:`SizeFlags<enum_Control_SizeFlags>` constants to change the flags. See the constants to learn what each does.
+Tells the parent :ref:`Container<class_Container>` nodes how they should resize and place the node on the X axis. Use a combination of the :ref:`SizeFlags<enum_Control_SizeFlags>` constants to change the flags. See the constants to learn what each does.
 
 .. rst-class:: classref-item-separator
 
@@ -1777,7 +1777,7 @@ If the node and at least one of its neighbors uses the :ref:`SIZE_EXPAND<class_C
 - void **set_v_size_flags** **(** :ref:`SizeFlags<enum_Control_SizeFlags>` value **)**
 - :ref:`SizeFlags<enum_Control_SizeFlags>` **get_v_size_flags** **(** **)**
 
-Tells the parent :ref:`Container<class_Container>` nodes how they should resize and place the node on the Y axis. Use one of the :ref:`SizeFlags<enum_Control_SizeFlags>` constants to change the flags. See the constants to learn what each does.
+Tells the parent :ref:`Container<class_Container>` nodes how they should resize and place the node on the Y axis. Use a combination of the :ref:`SizeFlags<enum_Control_SizeFlags>` constants to change the flags. See the constants to learn what each does.
 
 .. rst-class:: classref-item-separator
 

classes/class_editorexportplatformandroid.rst

@@ -612,6 +612,8 @@ Path of the debug keystore file.
 
 Can be overridden with the environment variable ``GODOT_ANDROID_KEYSTORE_DEBUG_PATH``.
 
+Fallbacks to ``EditorSettings.export/android/debug_keystore`` if empty.
+
 .. rst-class:: classref-item-separator
 
 ----
@@ -626,6 +628,8 @@ Password for the debug keystore file.
 
 Can be overridden with the environment variable ``GODOT_ANDROID_KEYSTORE_DEBUG_PASSWORD``.
 
+Fallbacks to ``EditorSettings.export/android/debug_keystore_pass`` if both it and :ref:`keystore/debug<class_EditorExportPlatformAndroid_property_keystore/debug>` are empty.
+
 .. rst-class:: classref-item-separator
 
 ----
@@ -640,6 +644,8 @@ User name for the debug keystore file.
 
 Can be overridden with the environment variable ``GODOT_ANDROID_KEYSTORE_DEBUG_USER``.
 
+Fallbacks to ``EditorSettings.export/android/debug_keystore_user`` if both it and :ref:`keystore/debug<class_EditorExportPlatformAndroid_property_keystore/debug>` are empty.
+
 .. rst-class:: classref-item-separator
 
 ----
@@ -716,7 +722,7 @@ Foreground layer of the application adaptive icon file.
 
 :ref:`String<class_String>` **launcher_icons/main_192x192**
 
-Application icon file. If left empty, project icon is used instead.
+Application icon file. If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`.
 
 .. rst-class:: classref-item-separator
 

classes/class_editorexportplatformios.rst

@@ -390,7 +390,7 @@ Path to the custom export template. If left empty, default template is used.
 
 :ref:`String<class_String>` **icons/app_store_1024x1024**
 
-App Store application icon file. If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+App Store application icon file. If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -402,7 +402,7 @@ App Store application icon file. If left empty, project icon is used instead. Se
 
 :ref:`String<class_String>` **icons/ipad_76x76**
 
-Home screen application icon file on iPad (1x DPI). If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+Home screen application icon file on iPad (1x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -414,7 +414,7 @@ Home screen application icon file on iPad (1x DPI). If left empty, project icon
 
 :ref:`String<class_String>` **icons/ipad_152x152**
 
-Home screen application icon file on iPad (2x DPI). If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+Home screen application icon file on iPad (2x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -426,7 +426,7 @@ Home screen application icon file on iPad (2x DPI). If left empty, project icon
 
 :ref:`String<class_String>` **icons/ipad_167x167**
 
-Home screen application icon file on iPad (3x DPI). If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+Home screen application icon file on iPad (3x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -438,7 +438,7 @@ Home screen application icon file on iPad (3x DPI). If left empty, project icon
 
 :ref:`String<class_String>` **icons/iphone_120x120**
 
-Home screen application icon file on iPhone (2x DPI). If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+Home screen application icon file on iPhone (2x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -450,7 +450,7 @@ Home screen application icon file on iPhone (2x DPI). If left empty, project ico
 
 :ref:`String<class_String>` **icons/iphone_180x180**
 
-Home screen application icon file on iPhone (3x DPI). If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+Home screen application icon file on iPhone (3x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -462,7 +462,7 @@ Home screen application icon file on iPhone (3x DPI). If left empty, project ico
 
 :ref:`String<class_String>` **icons/notification_40x40**
 
-Notification icon file on iPad and iPhone (2x DPI). If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+Notification icon file on iPad and iPhone (2x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -474,7 +474,7 @@ Notification icon file on iPad and iPhone (2x DPI). If left empty, project icon
 
 :ref:`String<class_String>` **icons/notification_60x60**
 
-Notification icon file on iPhone (3x DPI). If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+Notification icon file on iPhone (3x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -486,7 +486,7 @@ Notification icon file on iPhone (3x DPI). If left empty, project icon is used i
 
 :ref:`String<class_String>` **icons/settings_58x58**
 
-Application settings icon file on iPad and iPhone (2x DPI). If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+Application settings icon file on iPad and iPhone (2x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -498,7 +498,7 @@ Application settings icon file on iPad and iPhone (2x DPI). If left empty, proje
 
 :ref:`String<class_String>` **icons/settings_87x87**
 
-Application settings icon file on iPhone (3x DPI). If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+Application settings icon file on iPhone (3x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -510,7 +510,7 @@ Application settings icon file on iPhone (3x DPI). If left empty, project icon i
 
 :ref:`String<class_String>` **icons/spotlight_40x40**
 
-Spotlight icon file on iPad (1x DPI). If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+Spotlight icon file on iPad (1x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -522,7 +522,7 @@ Spotlight icon file on iPad (1x DPI). If left empty, project icon is used instea
 
 :ref:`String<class_String>` **icons/spotlight_80x80**
 
-Spotlight icon file on iPad and iPhone (2x DPI). If left empty, project icon is used instead. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
+Spotlight icon file on iPad and iPhone (2x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`. See `App icons <https://developer.apple.com/design/human-interface-guidelines/foundations/app-icons>`__.
 
 .. rst-class:: classref-item-separator
 
@@ -534,7 +534,7 @@ Spotlight icon file on iPad and iPhone (2x DPI). If left empty, project icon is
 
 :ref:`String<class_String>` **landscape_launch_screens/ipad_1024x768**
 
-Application launch screen image file, if left empty project splash screen is used instead.
+Application launch screen image file. If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -546,7 +546,7 @@ Application launch screen image file, if left empty project splash screen is use
 
 :ref:`String<class_String>` **landscape_launch_screens/ipad_2048x1536**
 
-Application launch screen image file, if left empty project splash screen is used instead.
+Application launch screen image file. If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -558,7 +558,7 @@ Application launch screen image file, if left empty project splash screen is use
 
 :ref:`String<class_String>` **landscape_launch_screens/iphone_2208x1242**
 
-Application launch screen image file, if left empty project splash screen is used instead.
+Application launch screen image file. If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -570,7 +570,7 @@ Application launch screen image file, if left empty project splash screen is use
 
 :ref:`String<class_String>` **landscape_launch_screens/iphone_2436x1125**
 
-Application launch screen image file, if left empty project splash screen is used instead.
+Application launch screen image file. If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -582,7 +582,7 @@ Application launch screen image file, if left empty project splash screen is use
 
 :ref:`String<class_String>` **portrait_launch_screens/ipad_768x1024**
 
-Application launch screen image file, if left empty project splash screen is used instead.
+Application launch screen image file. If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -594,7 +594,7 @@ Application launch screen image file, if left empty project splash screen is use
 
 :ref:`String<class_String>` **portrait_launch_screens/ipad_1536x2048**
 
-Application launch screen image file, if left empty project splash screen is used instead.
+Application launch screen image file. If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -606,7 +606,7 @@ Application launch screen image file, if left empty project splash screen is use
 
 :ref:`String<class_String>` **portrait_launch_screens/iphone_640x960**
 
-Application launch screen image file, if left empty project splash screen is used instead.
+Application launch screen image file. If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -618,7 +618,7 @@ Application launch screen image file, if left empty project splash screen is use
 
 :ref:`String<class_String>` **portrait_launch_screens/iphone_640x1136**
 
-Application launch screen image file, if left empty project splash screen is used instead.
+Application launch screen image file. If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -630,7 +630,7 @@ Application launch screen image file, if left empty project splash screen is use
 
 :ref:`String<class_String>` **portrait_launch_screens/iphone_750x1334**
 
-Application launch screen image file, if left empty project splash screen is used instead.
+Application launch screen image file. If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -642,7 +642,7 @@ Application launch screen image file, if left empty project splash screen is use
 
 :ref:`String<class_String>` **portrait_launch_screens/iphone_1125x2436**
 
-Application launch screen image file, if left empty project splash screen is used instead.
+Application launch screen image file. If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -654,7 +654,7 @@ Application launch screen image file, if left empty project splash screen is use
 
 :ref:`String<class_String>` **portrait_launch_screens/iphone_1242x2208**
 
-Application launch screen image file, if left empty project splash screen is used instead.
+Application launch screen image file. If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -750,7 +750,7 @@ A custom background color of the storyboard launch screen.
 
 :ref:`String<class_String>` **storyboard/custom_image@2x**
 
-Application launch screen image file (2x DPI), if left empty project splash screen is used instead.
+Application launch screen image file (2x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 
@@ -762,7 +762,7 @@ Application launch screen image file (2x DPI), if left empty project splash scre
 
 :ref:`String<class_String>` **storyboard/custom_image@3x**
 
-Application launch screen image file (3x DPI), if left empty project splash screen is used instead.
+Application launch screen image file (3x DPI). If left empty, it will fallback to :ref:`ProjectSettings.application/boot_splash/image<class_ProjectSettings_property_application/boot_splash/image>`.
 
 .. rst-class:: classref-item-separator
 

classes/class_editorexportplatformmacos.rst

@@ -272,7 +272,7 @@ Copyright notice for the bundle visible to the user (localized).
 
 :ref:`String<class_String>` **application/icon**
 
-Application icon file. If left empty, project icon is used instead.
+Application icon file. If left empty, it will fallback to :ref:`ProjectSettings.application/config/macos_native_icon<class_ProjectSettings_property_application/config/macos_native_icon>`, and  then to :ref:`ProjectSettings.application/config/icon<class_ProjectSettings_property_application/config/icon>`.
 
 .. rst-class:: classref-item-separator