api: add support of pointer names in function string_eval_expression (direct and in hdata)

These two formats are now supported, if "pointer_name" is present in the
"pointers" hashtable:

* "${pointer_name}": value of pointer (example: "0x1234abcd")
* ${buffer[pointer_name].full_name}: use of a pointer name instead of pointer
  value or list name

2 files changed, 12 insertions, 3 deletions

diff --git a/doc/fr/includes/autogen_user_commands.fr.adoc b/doc/fr/includes/autogen_user_commands.fr.adoc
index 168484b98..5ebc45cd4 100644
--- a/doc/fr/includes/autogen_user_commands.fr.adoc
+++ b/doc/fr/includes/autogen_user_commands.fr.adoc
@@ -1364,11 +1364,12 @@ Des variables sont remplacées dans l'expression, en utilisant le format ${varia
   20. un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants.
 Le format du hdata peut être le suivant :
   hdata.var1.var2... : démarrer avec un hdata (le pointeur doit être connu), et demander les variables l'une après l'autre (d'autres hdata peuvent être suivis)
-  hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste, par exemple :
+  hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste/pointeur/nom de pointeur, par exemple :
     ${buffer[gui_buffers].full_name} : nom complet du premier tampon dans la liste chaînée des tampons
     ${plugin[weechat_plugins].name} : nom de la première extension dans la liste chaînée des extensions
   hdata[pointeur].var1.var2... : démarrer avec un hdata en utilisant un pointeur, par exemple :
     ${buffer[0x1234abcd].full_name} : nom complet du tampon avec ce pointeur (peut être utilisé dans les triggers)
+    ${buffer[my_pointer].full_name} : nom complet du tampon avec ce nom de pointeur (peut être utilisé dans les triggers)
 Pour le nom du hdata et des variables, voir la "Référence API extension", fonction "weechat_hdata_get".
 
 Exemples (chaînes simples) :
diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc
index d9a670c4e..a95f4c1e5 100644
--- a/doc/fr/weechat_plugin_api.fr.adoc
+++ b/doc/fr/weechat_plugin_api.fr.adoc
@@ -2246,7 +2246,7 @@ str3 = weechat.string_input_for_buffer("//test")  # "/test"
 ==== string_eval_expression
 
 _WeeChat ≥ 0.4.0, mis à jour dans la 0.4.2, 0.4.3, 1.0, 1.1, 1.2, 1.3, 1.6, 1.8,
-2.0, 2.2, 2.3, 2.7, 2.9 et 3.1._
+2.0, 2.2, 2.3, 2.7, 2.9, 3.1 et 3.2._
 
 Évaluer l'expression et retourner le résultat sous forme de chaîne.
 Les variables spéciales avec le format `+${variable}+` sont étendues (voir le
@@ -2800,11 +2800,19 @@ première étendue à la dernière) :
   `+${nick}+` |
   `+FlashCode+`
 
+| `+${pointeur}+` |
+  Variable `pointeur` de la table de hachage _pointers_. |
+  `+${mon_pointeur}+` |
+  `+0x1234abcd+`
+
 | `+${hdata.var1.var2...}+` +
   `+${hdata[list].var1.var2...}+` |
   Valeur d'un hdata (les pointeurs `window` et `buffer` sont définis par défaut
-  avec la fenêtre et tampon courants). |
+  avec la fenêtre et tampon courants), `list` peut être le nom d'une liste
+  (exemple : "gui_buffers"), un pointeur (exemple : "0x1234abcd") ou un nom
+  de pointeur (exemple : "mon_pointeur"). |
   `+${buffer[gui_buffers].full_name}+` +
+  `+${buffer[mon_pointeur_buffer].full_name}+` +
   `+${window.buffer.number}+` |
   `+core.weechat+` +
   `+1+`