Skip to content

Commit 0a7aa19

Browse files
committed
Stop referring to GDExtension as experimental
1 parent d0f4813 commit 0a7aa19

File tree

3 files changed

+9
-21
lines changed

3 files changed

+9
-21
lines changed

tutorials/migrating/upgrading_to_godot_4.1.rst

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -242,9 +242,6 @@ Multiple layered ``SubViewportContainer`` nodes, that should all receive mouse i
242242
Updating your GDExtension for 4.1
243243
---------------------------------
244244

245-
GDExtension is still in beta. Until it's marked as stable, compatibility may break when
246-
upgrading to a new minor version of Godot.
247-
248245
In order to fix a serious bug, in Godot 4.1 we had to break binary compatibility in a big
249246
way and source compatibility in a small way.
250247

tutorials/scripting/gdextension/gdextension_cpp_example.rst

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -44,14 +44,12 @@ of Godot. GDExtensions will not work in older versions of Godot (only Godot 4 an
4444
to work with Godot's ``master`` branch.
4545

4646
.. warning::
47-
Our long-term goal is that GDExtensions targeting an earlier version of Godot will work
48-
in later minor versions, but not vice-versa. For example, a GDExtension targeting Godot 4.1
49-
should work just fine in Godot 4.2, but one targeting Godot 4.2 won't work in Godot 4.1.
50-
51-
However, GDExtension is currently *experimental*, which means that we may break compatibility
52-
in order to fix major bugs or include critical features. For example, GDExtensions created
53-
for Godot 4.0 aren't compatible with Godot 4.1
54-
(see :ref:`updating_your_gdextension_for_godot_4_1`).
47+
GDExtensions targeting an earlier version of Godot should work in later
48+
minor versions, but not vice-versa. For example, a GDExtension targeting Godot 4.2
49+
should work just fine in Godot 4.3, but one targeting Godot 4.3 won't work in Godot 4.2.
50+
51+
There is one exception to this: extensions targeting Godot 4.0 will _not_ work with
52+
Godot 4.1 and later (see :ref:`updating_your_gdextension_for_godot_4_1`).
5553

5654
If you are versioning your project using Git, it is recommended to add it as
5755
a Git submodule:

tutorials/scripting/gdextension/what_is_gdextension.rst

Lines changed: 3 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -22,11 +22,6 @@ run C or C++ code in a Godot project.
2222
They also both allow you to integrate third-party libraries into Godot. The one
2323
you should choose depends on your needs.
2424

25-
.. warning::
26-
27-
GDExtension is currently *experimental*, which means that we may
28-
break compatibility in order to fix major bugs or include critical features.
29-
3025
Advantages of GDExtension
3126
~~~~~~~~~~~~~~~~~~~~~~~~~
3227

@@ -106,18 +101,16 @@ The bindings below are developed and maintained by the community:
106101
Version compatibility
107102
---------------------
108103

109-
Usually, GDExtensions targeting an earlier version of Godot will work in later
104+
GDExtensions targeting an earlier version of Godot should work in later
110105
minor versions, but not vice-versa. For example, a GDExtension targeting Godot 4.2
111106
should work just fine in Godot 4.3, but one targeting Godot 4.3 won't work in Godot 4.2.
112107

113108
For this reason, when creating GDExtensions, you may want to target the lowest version of
114109
Godot that has the features you need, *not* the most recent version of Godot. This can
115110
save you from needing to create multiple builds for different versions of Godot.
116111

117-
However, GDExtension is currently *experimental*, which means that we may
118-
break compatibility in order to fix major bugs or include critical features.
119-
For example, GDExtensions created for Godot 4.0 aren't compatible with Godot
120-
4.1 (see :ref:`updating_your_gdextension_for_godot_4_1`).
112+
There is one exception to this: extensions targeting Godot 4.0 will _not_ work with
113+
Godot 4.1 and later (see :ref:`updating_your_gdextension_for_godot_4_1`).
121114

122115
GDExtensions are also only compatible with engine builds that use the same
123116
level of floating-point precision the extension was compiled for. This means

0 commit comments

Comments
 (0)