From ac3b77fa1a49b313fdc2cc03741b4a9fb59f8431 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Thu, 5 Feb 2026 12:53:49 +0100
Subject: [PATCH] Add algorithm categorization note to hash_algos()

Fixes #3616
---
 reference/hash/functions/hash-algos.xml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/reference/hash/functions/hash-algos.xml b/reference/hash/functions/hash-algos.xml
index 2e82d13deb11..014ebdd03b58 100644
--- a/reference/hash/functions/hash-algos.xml
+++ b/reference/hash/functions/hash-algos.xml
@@ -24,6 +24,14 @@
    Returns a numerically indexed array containing the list of supported
    hashing algorithms.
   </para>
+  <note>
+   <simpara>
+    Not all algorithms are suitable for every use case.
+    See the <link linkend="intro.hash">Hash extension introduction</link>
+    for a description of the different categories (checksum,
+    non-cryptographic, and cryptographic).
+   </simpara>
+  </note>
  </refsect1>
 
  <refsect1 role="changelog">