commit 1263db3: [Minor] Slightly improve the documentation

Vsevolod Stakhov vsevolod at rspamd.com
Sun Oct 30 08:35:03 UTC 2022


Author: Vsevolod Stakhov
Date: 2022-10-29 21:29:50 +0100
URL: https://github.com/rspamd/rspamd/commit/1263db3fe0db50dae0a1a08281aed396fbe99dee

[Minor] Slightly improve the documentation

---
 src/lua/lua_task.c | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/src/lua/lua_task.c b/src/lua/lua_task.c
index 263ec484e..3288b8385 100644
--- a/src/lua/lua_task.c
+++ b/src/lua/lua_task.c
@@ -716,9 +716,11 @@ LUA_FUNCTION_DEF (task, get_dkim_results);
 /***
  * @method task:get_symbol(name, [shadow_result_name])
  * Searches for a symbol `name` in all metrics results and returns a list of tables
- * one per metric that describes the symbol inserted. Please note that this function
- * is intended to return values for **inserted** symbols, so if this symbol was not
- * inserted it won't be in the function's output. This method is useful for post-filters mainly.
+ * one per metric that describes the symbol inserted.
+ * Please note, that for using this function you need to ensure that the symbol
+ * being queried is already checked. This is guaranteed if there is a dependency
+ * between the caller symbol and the checked symbol (either virtual or real).
+ * Please check `rspamd_config:register_dependency` method for details.
  * The symbols are returned as the list of the following tables:
  *
  * - `metric` - name of metric
@@ -777,7 +779,11 @@ LUA_FUNCTION_DEF (task, process_ann_tokens);
 
 /***
  * @method task:has_symbol(name, [shadow_result_name])
- * Fast path to check if a specified symbol is in the task's results
+ * Fast path to check if a specified symbol is in the task's results.
+ * Please note, that for using this function you need to ensure that the symbol
+ * being queried is already checked. This is guaranteed if there is a dependency
+ * between the caller symbol and the checked symbol (either virtual or real).
+ * Please check `rspamd_config:register_dependency` method for details.
  * @param {string} name symbol's name
  * @return {boolean} `true` if symbol has been found
  */


More information about the Commits mailing list