doc: add note about double tab in function weechat_printf, to display message without time/alignment (plugin API reference)

3 files changed, 27 insertions, 0 deletions

diff --git a/doc/en/weechat_plugin_api.en.txt b/doc/en/weechat_plugin_api.en.txt
index 1186f9ec7..1f1028052 100644
--- a/doc/en/weechat_plugin_api.en.txt
+++ b/doc/en/weechat_plugin_api.en.txt
@@ -6303,6 +6303,10 @@ If your message has some tabs and if you don't want prefix, then use a space,
 a tab, then message (see example below): this will disable prefix (the space
 before tab will not be displayed).
 
+[NOTE]
+With two tabs ("\t") at beginning of message, time will not be displayed and
+message will have no alignment at all (like the message "Day changed to").
+
 C example:
 
 [source,C]
@@ -6311,6 +6315,8 @@ weechat_printf (NULL, "Hello on WeeChat buffer");
 weechat_printf (buffer, "Hello on this buffer");
 weechat_printf (buffer, "%sThis is an error!", weechat_prefix ("error"));
 weechat_printf (buffer, " \tMessage without prefix but with \t some \t tabs");
+weechat_printf (buffer, "\t\tMessage without time/alignment");
+weechat_printf (buffer, "\t\t"); /* empty line (without time) */
 ----------------------------------------
 
 Script (Python):
@@ -6325,6 +6331,8 @@ weechat.prnt("", "Hello on WeeChat buffer")
 weechat.prnt(buffer, "Hello on this buffer")
 weechat.prnt(buffer, "%sThis is an error!" % weechat.prefix("error"))
 weechat.prnt(buffer, " \tMessage without prefix but with \t some \t tabs")
+weechat.prnt(buffer, "\t\tMessage without time/alignment")
+weechat.prnt(buffer, "\t\t") # empty line (without time)
 ----------------------------------------
 
 [NOTE]
diff --git a/doc/fr/weechat_plugin_api.fr.txt b/doc/fr/weechat_plugin_api.fr.txt
index 7b59a7e16..0258c7ea3 100644
--- a/doc/fr/weechat_plugin_api.fr.txt
+++ b/doc/fr/weechat_plugin_api.fr.txt
@@ -6380,6 +6380,10 @@ Si votre message contient des tabulations et si vous ne voulez pas de préfixe,
 utilisez un espace, une tabulation, puis le message : cela désactivera le
 préfixe (l'espace avant la tabulation ne sera pas affiché).
 
+[NOTE]
+Avec deux tabulations ("\t") au début du message, l'heure ne sera pas affichée
+et le message n'aura pas d'alignement (comme le message "Jour changé").
+
 Exemple en C :
 
 [source,C]
@@ -6388,6 +6392,8 @@ weechat_printf (NULL, "Bonjour sur le tampon WeeChat");
 weechat_printf (buffer, "Bonjour sur ce tampon");
 weechat_printf (buffer, "%sCeci est une erreur !", weechat_prefix ("error"));
 weechat_printf (buffer, " \tMessage sans préfixe mais avec \t quelques \t tabulations");
+weechat_printf (buffer, "\t\tMessage sans heure/alignement");
+weechat_printf (buffer, "\t\t"); /* ligne vide (sans heure) */
 ----------------------------------------
 
 Script (Python) :
@@ -6402,6 +6408,8 @@ weechat.prnt("", "Bonjour sur le tampon WeeChat")
 weechat.prnt(buffer, "Bonjour sur ce tampon")
 weechat.prnt(buffer, "%sCeci est une erreur !" % weechat.prefix("error"))
 weechat.prnt(buffer, " \tMessage sans préfixe mais avec \t quelques \t tabulations")
+weechat.prnt(buffer, "\t\tMessage sans heure/alignement")
+weechat.prnt(buffer, "\t\t") # ligne vide (sans heure)
 ----------------------------------------
 
 [NOTE]
diff --git a/doc/it/weechat_plugin_api.it.txt b/doc/it/weechat_plugin_api.it.txt
index 380d13e86..3587a60b9 100644
--- a/doc/it/weechat_plugin_api.it.txt
+++ b/doc/it/weechat_plugin_api.it.txt
@@ -6320,18 +6320,27 @@ bisogna utilizzare uno spazio, una tabulazione, poi il messaggio (consultare
 l'esempio successivo): ciò disabilita il prefisso (lo spazio prima della
 tabulazione non verrà mostrato).
 
+// TRANSLATION MISSING
+[NOTE]
+With two tabs ("\t") at beginning of message, time will not be displayed and
+message will have no alignment at all (like the message "Day changed to").
+
 Esempio in C:
 
+// TRANSLATION MISSING
 [source,C]
 ----------------------------------------
 weechat_printf (NULL, "Benvenuto sul buffer di WeeChat");
 weechat_printf (buffer, "Benvenuto su questo buffer");
 weechat_printf (buffer, "%sQuesto è un errore!", weechat_prefix ("error"));
 weechat_printf (buffer, " \tMessaggio senza prefisso ma con \t alcune \t tabulazioni");
+weechat_printf (buffer, "\t\tMessage without time/alignment");
+weechat_printf (buffer, "\t\t"); /* empty line (without time) */
 ----------------------------------------
 
 Script (Python):
 
+// TRANSLATION MISSING
 [source,python]
 ----------------------------------------
 # prototipo
@@ -6342,6 +6351,8 @@ weechat.prnt("", "Benvenuto sul buffer di WeeChat")
 weechat.prnt(buffer, "Benvenuto su questo buffer")
 weechat.prnt(buffer, "%sQuesto è un errore!" % weechat.prefix("error"))
 weechat.prnt(buffer, " \tMessaggio senza prefisso ma con \t alcune \t tabulazioni")
+weechat.prnt(buffer, "\t\tMessage without time/alignment")
+weechat.prnt(buffer, "\t\t") # empty line (without time)
 ----------------------------------------
 
 [NOTE]