From 6cf467cc9fdcce1c0dbcf853a6ba00ca2831babd Mon Sep 17 00:00:00 2001
From: Niels Dossche <7771979+nielsdos@users.noreply.github.com>
Date: Fri, 20 Sep 2024 23:36:41 +0200
Subject: [PATCH] Soap: Document how the current lookup functions work

---
 ext/soap/soap.c | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/ext/soap/soap.c b/ext/soap/soap.c
index f8bfb57ba6b..2098c19a42c 100644
--- a/ext/soap/soap.c
+++ b/ext/soap/soap.c
@@ -3058,6 +3058,8 @@ static void deserialize_parameters(xmlNodePtr params, sdlFunctionPtr function, u
 }
 /* }}} */
 
+/* This function attempts to find the right function name based on the first node's name in the soap body.
+ * If that doesn't work it falls back to get_doc_function(). */
 static sdlFunctionPtr find_function(sdlPtr sdl, xmlNodePtr func, zval* function_name) /* {{{ */
 {
 	sdlFunctionPtr function;
@@ -4185,6 +4187,10 @@ static sdlFunctionPtr get_function(sdlPtr sdl, const char *function_name, size_t
 }
 /* }}} */
 
+/* This function tries to find the function that matches the given parameters.
+ * If params is NULL, it will return the first function that has no parameters.
+ * If params is not NULL, it will return the first function that has the same
+ * parameters as the given XML node. */
 static sdlFunctionPtr get_doc_function(sdlPtr sdl, xmlNodePtr params) /* {{{ */
 {
 	if (sdl) {