From 8239500a12efc3f649e90c0c173e65c687496f5e Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Sat, 12 Jul 2025 20:59:49 +0200
Subject: [PATCH] add a warning for callback and array with less than 2 items

---
 language-snippets.ent | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/language-snippets.ent b/language-snippets.ent
index 399989611245..bd5918e08d91 100644
--- a/language-snippets.ent
+++ b/language-snippets.ent
@@ -739,6 +739,11 @@ use.</simpara></note>'>
   <literal>0.99</literal> and <literal>0.1</literal> will both be cast to an
   integer value of <literal>0</literal>, which will compare such values as equal.
  </para>
+ <para>
+  The callback is not called if the input has less than 2 items,
+  an error (e.g. accessing an invalid key of an array) or an exception
+  will not be reported, unless you test it with 2 items or more.
+ </para>
 </caution>'>
 
 <!ENTITY sort.callback.description.presort '<caution xmlns="http://docbook.org/ns/docbook">