diff --git a/tutorials/migrating/upgrading_to_godot_4.5.rst b/tutorials/migrating/upgrading_to_godot_4.5.rst index f27e065ee..f09d17af5 100644 --- a/tutorials/migrating/upgrading_to_godot_4.5.rst +++ b/tutorials/migrating/upgrading_to_godot_4.5.rst @@ -204,6 +204,17 @@ new behavior, you must change the "Naming Version" option at the bottom of the I Core ~~~~ +.. note:: + + :ref:`ProjectSettings.add_property_info() ` + now prints a warning when the dictionary parameter has missing keys or invalid keys. + Most importantly, it will now warn when a ``usage`` key is passed, as this key is not used. + This was also the case before 4.5, but it was silently ignored instead. + As a reminder, to set property usage information correctly, you must use + :ref:`ProjectSettings.set_as_basic() `, + :ref:`ProjectSettings.set_restart_if_changed() `, + or :ref:`ProjectSettings.set_as_internal() ` instead. + .. note:: In C#, ``StringExtensions.PathJoin`` now avoids adding an extra path separator when the original string is empty,