From 1225efe472fc18ed6a0a3c1aef1dfb01f8758d15 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= <flashcode@flashtux.org>
Date: Fri, 3 Nov 2017 22:03:02 +0100
Subject: [PATCH] doc: add info about strings not translated in functions
 gettext/ngettext (plugin API reference)

---
 doc/en/weechat_plugin_api.en.adoc | 5 +++--
 doc/fr/weechat_plugin_api.fr.adoc | 5 +++--
 doc/it/weechat_plugin_api.it.adoc | 7 +++++--
 doc/ja/weechat_plugin_api.ja.adoc | 7 +++++--
 4 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc
index a90330736..f0e0c1c20 100644
--- a/doc/en/weechat_plugin_api.en.adoc
+++ b/doc/en/weechat_plugin_api.en.adoc
@@ -418,7 +418,7 @@ Arguments:
 
 Return value:
 
-* translated string
+* translated string or _string_ if there is no translation available in local language
 
 C example:
 
@@ -460,7 +460,8 @@ Arguments:
 
 Return value:
 
-* translated string
+* translated string or _string_ / _plural_ if there is no translation available
+  in local language
 
 C example:
 
diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc
index 1edd14991..3291f6182 100644
--- a/doc/fr/weechat_plugin_api.fr.adoc
+++ b/doc/fr/weechat_plugin_api.fr.adoc
@@ -427,7 +427,7 @@ Paramètres :
 
 Valeur de retour :
 
-* chaîne traduite
+* chaîne traduite ou _string_ s'il n'y a pas de traduction disponible dans la langue locale
 
 Exemple en C :
 
@@ -469,7 +469,8 @@ Paramètres :
 
 Valeur de retour :
 
-* chaîne traduite
+* chaîne traduite ou _string_ / _plural_ s'il n'y a pas de traduction disponible
+  dans la langue locale
 
 Exemple en C :
 
diff --git a/doc/it/weechat_plugin_api.it.adoc b/doc/it/weechat_plugin_api.it.adoc
index 5eee0268e..3ba56b2b7 100644
--- a/doc/it/weechat_plugin_api.it.adoc
+++ b/doc/it/weechat_plugin_api.it.adoc
@@ -442,7 +442,8 @@ Argomenti:
 
 Valore restituito:
 
-* stringa tradotta
+// TRANSLATION MISSING
+* translated string or _string_ if there is no translation available in local language
 
 Esempio in C:
 
@@ -484,7 +485,9 @@ Argomenti:
 
 Valore restituito:
 
-* stringa tradotta
+// TRANSLATION MISSING
+* translated string or _string_ / _plural_ if there is no translation available
+  in local language
 
 Esempio in C:
 
diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc
index 88140ae7f..0ad82ee3e 100644
--- a/doc/ja/weechat_plugin_api.ja.adoc
+++ b/doc/ja/weechat_plugin_api.ja.adoc
@@ -424,7 +424,8 @@ const char *weechat_gettext (const char *string);
 
 戻り値:
 
-* 翻訳済み文字列
+// TRANSLATION MISSING
+* translated string or _string_ if there is no translation available in local language
 
 C 言語での使用例:
 
@@ -466,7 +467,9 @@ const char *weechat_ngettext (const char *string, const char *plural,
 
 戻り値:
 
-* 翻訳済みの文字列
+// TRANSLATION MISSING
+* translated string or _string_ / _plural_ if there is no translation available
+  in local language
 
 C 言語での使用例: