diff --git a/tutorials/migrating/upgrading_to_godot_4.1.rst b/tutorials/migrating/upgrading_to_godot_4.1.rst index 2529320b30a..a4836543058 100644 --- a/tutorials/migrating/upgrading_to_godot_4.1.rst +++ b/tutorials/migrating/upgrading_to_godot_4.1.rst @@ -242,9 +242,6 @@ Multiple layered ``SubViewportContainer`` nodes, that should all receive mouse i Updating your GDExtension for 4.1 --------------------------------- -GDExtension is still in beta. Until it's marked as stable, compatibility may break when -upgrading to a new minor version of Godot. - In order to fix a serious bug, in Godot 4.1 we had to break binary compatibility in a big way and source compatibility in a small way. diff --git a/tutorials/scripting/gdextension/gdextension_cpp_example.rst b/tutorials/scripting/gdextension/gdextension_cpp_example.rst index 844693d0158..b22c0bf7b65 100644 --- a/tutorials/scripting/gdextension/gdextension_cpp_example.rst +++ b/tutorials/scripting/gdextension/gdextension_cpp_example.rst @@ -44,14 +44,12 @@ of Godot. GDExtensions will not work in older versions of Godot (only Godot 4 an to work with Godot's ``master`` branch. .. warning:: - Our long-term goal is that GDExtensions targeting an earlier version of Godot will work - in later minor versions, but not vice-versa. For example, a GDExtension targeting Godot 4.1 - should work just fine in Godot 4.2, but one targeting Godot 4.2 won't work in Godot 4.1. - - However, GDExtension is currently *experimental*, which means that we may break compatibility - in order to fix major bugs or include critical features. For example, GDExtensions created - for Godot 4.0 aren't compatible with Godot 4.1 - (see :ref:`updating_your_gdextension_for_godot_4_1`). + GDExtensions targeting an earlier version of Godot should work in later + minor versions, but not vice-versa. For example, a GDExtension targeting Godot 4.2 + should work just fine in Godot 4.3, but one targeting Godot 4.3 won't work in Godot 4.2. + + There is one exception to this: extensions targeting Godot 4.0 will _not_ work with + Godot 4.1 and later (see :ref:`updating_your_gdextension_for_godot_4_1`). If you are versioning your project using Git, it is recommended to add it as a Git submodule: diff --git a/tutorials/scripting/gdextension/what_is_gdextension.rst b/tutorials/scripting/gdextension/what_is_gdextension.rst index 2abd5319919..48b38b4ef22 100644 --- a/tutorials/scripting/gdextension/what_is_gdextension.rst +++ b/tutorials/scripting/gdextension/what_is_gdextension.rst @@ -22,11 +22,6 @@ run C or C++ code in a Godot project. They also both allow you to integrate third-party libraries into Godot. The one you should choose depends on your needs. -.. warning:: - - GDExtension is currently *experimental*, which means that we may - break compatibility in order to fix major bugs or include critical features. - Advantages of GDExtension ~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -106,7 +101,7 @@ The bindings below are developed and maintained by the community: Version compatibility --------------------- -Usually, GDExtensions targeting an earlier version of Godot will work in later +GDExtensions targeting an earlier version of Godot should work in later minor versions, but not vice-versa. For example, a GDExtension targeting Godot 4.2 should work just fine in Godot 4.3, but one targeting Godot 4.3 won't work in Godot 4.2. @@ -114,10 +109,8 @@ For this reason, when creating GDExtensions, you may want to target the lowest v Godot that has the features you need, *not* the most recent version of Godot. This can save you from needing to create multiple builds for different versions of Godot. -However, GDExtension is currently *experimental*, which means that we may -break compatibility in order to fix major bugs or include critical features. -For example, GDExtensions created for Godot 4.0 aren't compatible with Godot -4.1 (see :ref:`updating_your_gdextension_for_godot_4_1`). +There is one exception to this: extensions targeting Godot 4.0 will _not_ work with +Godot 4.1 and later (see :ref:`updating_your_gdextension_for_godot_4_1`). GDExtensions are also only compatible with engine builds that use the same level of floating-point precision the extension was compiled for. This means