From 831f645841d62b88a22aac1b3dcbefad205253aa Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Fri, 7 Nov 2025 00:29:32 +0100
Subject: [PATCH] Document `Object.connect()` not supporting persistent
 connections with lambda functions

---
 doc/classes/Object.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/classes/Object.xml b/doc/classes/Object.xml
index e88856f2bead..7e5e4fc27675 100644
--- a/doc/classes/Object.xml
+++ b/doc/classes/Object.xml
@@ -1040,6 +1040,7 @@
 		</constant>
 		<constant name="CONNECT_PERSIST" value="2" enum="ConnectFlags">
 			Persisting connections are stored when the object is serialized (such as when using [method PackedScene.pack]). In the editor, connections created through the Node dock are always persisting.
+			[b]Note:[/b] Connections to lambda functions (i.e. when the function code is embedded in the [method connect] call) cannot be made persistent.
 		</constant>
 		<constant name="CONNECT_ONE_SHOT" value="4" enum="ConnectFlags">
 			One-shot connections disconnect themselves after emission.