From 60532145e3ad5965c37c4971a88eda3762d5b00f Mon Sep 17 00:00:00 2001
From: Benjamin Renard <brenard@easter-eggs.com>
Date: Tue, 25 May 2021 10:37:30 +0200
Subject: [PATCH] doc: add some details about filter parameter of search
 LSobject API method

---
 doc/api/api.docbook | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/api/api.docbook b/doc/api/api.docbook
index d8b6d872..77881793 100644
--- a/doc/api/api.docbook
+++ b/doc/api/api.docbook
@@ -97,8 +97,10 @@
             <listitem><simpara>Permet de spécifier un filtre de recherche LDAP personnalisé. Celui-ci
             sera combiné avec les paramètres propres au type d'objets recherchés et aux autres
             paramètres spécifiés (<literal>pattern</literal> par exemple).</simpara>
-            <warning><simpara>Pour le moment, seuls les filtres simples du type <literal>attribut=valeur
-            </literal> sont acceptés ici.</simpara></warning>
+            <warning><simpara>Du fait d'une limitation de la classe <literal>Net_LDAP2_Filter</literal>
+            utilisée pour analyser le filtre passé en paramètre, seuls les filtres simples du type
+            <literal>(attribut=valeur)</literal> sont acceptés ici. Pour les mêmes raisons, il est
+            important que le filtre spécifié soit toujours entourné de paranthèses.</simpara></warning>
             </listitem>
           </varlistentry>