doc/api: fix formatting of return value in char/string comparison functions

5 files changed, 305 insertions, 259 deletions

diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc
index 440ce7853..991dea597 100644
--- a/doc/en/weechat_plugin_api.en.adoc
+++ b/doc/en/weechat_plugin_api.en.adoc
@@ -710,12 +710,13 @@ Arguments:
 * _string1_: first string for comparison
 * _string2_: second string for comparison
 
-Return value: arithmetic result of subtracting the first UTF-8 char in _string2_
-from the first UTF-8 char in _string1_:
+Return value:
 
-* < 0 if char1 < char2
-* 0 if char1 == char2
-* > 0 if char1 > char2
+* arithmetic result of subtracting the first UTF-8 char in _string2_
+  from the first UTF-8 char in _string1_:
+** < 0 if char1 < char2
+** 0 if char1 == char2
+** > 0 if char1 > char2
 
 C example:
 
@@ -750,13 +751,14 @@ Arguments:
 * _string1_: first string for comparison
 * _string2_: second string for comparison
 
-Return value: arithmetic result of subtracting the first UTF-8 char in _string2_
-(converted to lowercase) from the first UTF-8 char in _string1_ (converted to
-lowercase):
+Return value:
 
-* < 0 if char1 < char2
-* 0 if char1 == char2
-* > 0 if char1 > char2
+* arithmetic result of subtracting the first UTF-8 char in _string2_
+  (converted to lowercase) from the first UTF-8 char in _string1_ (converted to
+  lowercase):
+** < 0 if char1 < char2
+** 0 if char1 == char2
+** > 0 if char1 > char2
 
 C example:
 
@@ -786,12 +788,13 @@ Arguments:
 * _string1_: first string for comparison
 * _string2_: second string for comparison
 
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ from the last compared UTF-8 char in _string1_:
+Return value:
 
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ from the last compared UTF-8 char in _string1_:
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C example:
 
@@ -822,12 +825,13 @@ Arguments:
 * _string2_: second string for comparison
 * _max_: max chars to compare
 
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ from the last compared UTF-8 char in _string1_:
+Return value:
 
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ from the last compared UTF-8 char in _string1_:
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C example:
 
@@ -862,13 +866,14 @@ Arguments:
 * _string1_: first string for comparison
 * _string2_: second string for comparison
 
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C example:
 
@@ -908,13 +913,14 @@ Arguments:
 [NOTE]
 Values 29 and 30 are used by some protocols like IRC.
 
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C example:
 
@@ -950,13 +956,14 @@ Arguments:
 * _string2_: second string for comparison
 * _max_: max chars to compare
 
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C example:
 
@@ -995,13 +1002,14 @@ Arguments:
 [NOTE]
 Values 29 and 30 are used by some protocols like IRC.
 
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C example:
 
@@ -1040,14 +1048,15 @@ Behavior has changed in version 3.8 when _case_sensitive_ is set to 0: now all
 uppercase letters are properly converted to lowercase (by calling function
 `towlower`), in addition to the range `A` to `Z`.
 
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase if _case_sentitive_ is set to 0) from the last
-compared UTF-8 char in _string1_ (converted to lowercase if _case_sensitive_ is
-set to 0):
+Return value:
 
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase if _case_sentitive_ is set to 0) from the last
+  compared UTF-8 char in _string1_ (converted to lowercase if _case_sensitive_ is
+  set to 0):
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C example:
 
diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc
index 4c3fe899b..6c5a3bcc3 100644
--- a/doc/fr/weechat_plugin_api.fr.adoc
+++ b/doc/fr/weechat_plugin_api.fr.adoc
@@ -724,12 +724,13 @@ Paramètres :
 * _string1_ : première chaîne pour la comparaison
 * _string2_ : seconde chaîne pour la comparaison
 
-Valeur de retour : résultat de la soustraction du premier caractère UTF-8 dans
-_string2_ du premier caractère UTF-8 dans _string1_ :
+Valeur de retour :
 
-* < 0 si char1 < char2
-* 0 si char1 == char2
-* > 0 si char1 > char2
+* résultat de la soustraction du premier caractère UTF-8 dans
+  _string2_ du premier caractère UTF-8 dans _string1_ :
+** < 0 si char1 < char2
+** 0 si char1 == char2
+** > 0 si char1 > char2
 
 Exemple en C :
 
@@ -764,13 +765,14 @@ Paramètres :
 * _string1_ : première chaîne pour la comparaison
 * _string2_ : seconde chaîne pour la comparaison
 
-Valeur de retour : résultat de la soustraction du premier caractère UTF-8 dans
-_string2_ (converti en minuscule) du premier caractère UTF-8 dans _string1_
-(converti en minuscule) :
+Valeur de retour :
 
-* < 0 si char1 < char2
-* 0 si char1 == char2
-* > 0 si char1 > char2
+* résultat de la soustraction du premier caractère UTF-8 dans
+  _string2_ (converti en minuscule) du premier caractère UTF-8 dans _string1_
+  (converti en minuscule) :
+** < 0 si char1 < char2
+** 0 si char1 == char2
+** > 0 si char1 > char2
 
 Exemple en C :
 
@@ -800,12 +802,13 @@ Paramètres :
 * _string1_ : première chaîne à comparer
 * _string2_ : seconde chaîne à comparer
 
-Valeur de retour : résultat de la soustraction du dernier caractère UTF-8 comparé
-dans _string2_ du dernier caractère UTF-8 comparé dans _string1_ :
+Valeur de retour :
 
-* < 0 si string1 < string2
-* 0 si string1 == string2
-* > 0 si string1 > string2
+* résultat de la soustraction du dernier caractère UTF-8 comparé
+  dans _string2_ du dernier caractère UTF-8 comparé dans _string1_ :
+** < 0 si string1 < string2
+** 0 si string1 == string2
+** > 0 si string1 > string2
 
 Exemple en C :
 
@@ -836,12 +839,13 @@ Paramètres :
 * _string2_ : seconde chaîne à comparer
 * _max_ : nombre maximum de caractères à comparer
 
-Valeur de retour : résultat de la soustraction du dernier caractère UTF-8 comparé
-dans _string2_ du dernier caractère UTF-8 comparé dans _string1_ :
+Valeur de retour :
 
-* < 0 si string1 < string2
-* 0 si string1 == string2
-* > 0 si string1 > string2
+* résultat de la soustraction du dernier caractère UTF-8 comparé
+  dans _string2_ du dernier caractère UTF-8 comparé dans _string1_ :
+** < 0 si string1 < string2
+** 0 si string1 == string2
+** > 0 si string1 > string2
 
 Exemple en C :
 
@@ -876,13 +880,14 @@ Paramètres :
 * _string1_ : première chaîne à comparer
 * _string2_ : seconde chaîne à comparer
 
-Valeur de retour : résultat de la soustraction du dernier caractère UTF-8 comparé
-dans _string2_ (converti en minuscule) du dernier caractère UTF-8 comparé dans
-_string1_ (converti en minuscule) :
+Valeur de retour :
 
-* < 0 si string1 < string2
-* 0 si string1 == string2
-* > 0 si string1 > string2
+* résultat de la soustraction du dernier caractère UTF-8 comparé
+  dans _string2_ (converti en minuscule) du dernier caractère UTF-8 comparé dans
+  _string1_ (converti en minuscule) :
+** < 0 si string1 < string2
+** 0 si string1 == string2
+** > 0 si string1 > string2
 
 Exemple en C :
 
@@ -922,13 +927,14 @@ Paramètres :
 [NOTE]
 Les valeurs 29 et 30 sont utilisés par quelques protocoles comme IRC.
 
-Valeur de retour : résultat de la soustraction du dernier caractère UTF-8 comparé
-dans _string2_ (converti en minuscule) du dernier caractère UTF-8 comparé dans
-_string1_ (converti en minuscule) :
+Valeur de retour :
 
-* < 0 si string1 < string2
-* 0 si string1 == string2
-* > 0 si string1 > string2
+* résultat de la soustraction du dernier caractère UTF-8 comparé
+  dans _string2_ (converti en minuscule) du dernier caractère UTF-8 comparé dans
+  _string1_ (converti en minuscule) :
+** < 0 si string1 < string2
+** 0 si string1 == string2
+** > 0 si string1 > string2
 
 Exemple en C :
 
@@ -964,13 +970,14 @@ Paramètres :
 * _string2_ : seconde chaîne à comparer
 * _max_ : nombre maximum de caractères à comparer
 
-Valeur de retour : résultat de la soustraction du dernier caractère UTF-8 comparé
-dans _string2_ (converti en minuscule) du dernier caractère UTF-8 comparé dans
-_string1_ (converti en minuscule) :
+Valeur de retour :
 
-* < 0 si string1 < string2
-* 0 si string1 == string2
-* > 0 si string1 > string2
+* résultat de la soustraction du dernier caractère UTF-8 comparé
+  dans _string2_ (converti en minuscule) du dernier caractère UTF-8 comparé dans
+  _string1_ (converti en minuscule) :
+** < 0 si string1 < string2
+** 0 si string1 == string2
+** > 0 si string1 > string2
 
 Exemple en C :
 
@@ -1009,13 +1016,14 @@ Paramètres :
 [NOTE]
 Les valeurs 29 et 30 sont utilisés par quelques protocoles comme IRC.
 
-Valeur de retour : résultat de la soustraction du dernier caractère UTF-8 comparé
-dans _string2_ (converti en minuscule) du dernier caractère UTF-8 comparé dans
-_string1_ (converti en minuscule) :
+Valeur de retour :
 
-* < 0 si string1 < string2
-* 0 si string1 == string2
-* > 0 si string1 > string2
+* résultat de la soustraction du dernier caractère UTF-8 comparé
+  dans _string2_ (converti en minuscule) du dernier caractère UTF-8 comparé dans
+  _string1_ (converti en minuscule) :
+** < 0 si string1 < string2
+** 0 si string1 == string2
+** > 0 si string1 > string2
 
 Exemple en C :
 
@@ -1055,14 +1063,15 @@ positionné à 0 : désormais toutes les lettres en majuscules sont correctemen
 converties en minuscules (par appel à la fonction `towlower`), en plus de
 l'intervalle de `A` à `Z`.
 
-Valeur de retour : résultat de la soustraction du dernier caractère UTF-8 comparé
-dans _string2_ (converti en minuscule si _case_sensitive_ est positionné à 0)
-du dernier caractère UTF-8 comparé dans _string1_ (converti en minuscule si
-_case_sensitive_ est positionné à 0) :
+Valeur de retour :
 
-* < 0 si string1 < string2
-* 0 si string1 == string2
-* > 0 si string1 > string2
+* résultat de la soustraction du dernier caractère UTF-8 comparé
+  dans _string2_ (converti en minuscule si _case_sensitive_ est positionné à 0)
+  du dernier caractère UTF-8 comparé dans _string1_ (converti en minuscule si
+  _case_sensitive_ est positionné à 0) :
+** < 0 si string1 < string2
+** 0 si string1 == string2
+** > 0 si string1 > string2
 
 Exemple en C :
 
diff --git a/doc/it/weechat_plugin_api.it.adoc b/doc/it/weechat_plugin_api.it.adoc
index 9a86ff068..a06a47c3f 100644
--- a/doc/it/weechat_plugin_api.it.adoc
+++ b/doc/it/weechat_plugin_api.it.adoc
@@ -754,13 +754,14 @@ Argomenti:
 * _string2_: seconda stringa da comparare
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the first UTF-8 char in _string2_
-from the first UTF-8 char in _string1_:
+Return value:
 
+* arithmetic result of subtracting the first UTF-8 char in _string2_
+  from the first UTF-8 char in _string1_:
 // TRANSLATION MISSING
-* < 0 if char1 < char2
-* 0 if char1 == char2
-* > 0 if char1 > char2
+** < 0 if char1 < char2
+** 0 if char1 == char2
+** > 0 if char1 > char2
 
 Esempio in C:
 
@@ -798,13 +799,15 @@ Argomenti:
 * _string2_: seconda stringa da comparare
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the first UTF-8 char in _string2_
-(converted to lowercase) from the first UTF-8 char in _string1_ (converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the first UTF-8 char in _string2_
+  (converted to lowercase) from the first UTF-8 char in _string1_ (converted to
+  lowercase):
 // TRANSLATION MISSING
-* < 0 if char1 < char2
-* 0 if char1 == char2
-* > 0 if char1 > char2
+** < 0 if char1 < char2
+** 0 if char1 == char2
+** > 0 if char1 > char2
 
 Esempio in C:
 
@@ -837,13 +840,14 @@ Argomenti:
 * _string2_: seconda stringa da comparare
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ from the last compared UTF-8 char in _string1_:
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ from the last compared UTF-8 char in _string1_:
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 Esempio in C:
 
@@ -877,13 +881,14 @@ Argomenti:
 * _max_: numero massimo di caratteri da comparare
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ from the last compared UTF-8 char in _string1_:
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ from the last compared UTF-8 char in _string1_:
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 Esempio in C:
 
@@ -922,14 +927,15 @@ Argomenti:
 * _string2_: seconda stringa da comparare
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 Esempio in C:
 
@@ -971,14 +977,15 @@ Argomenti:
 I valori 29 e 30 vengono usati da alcuni protocolli come IRC.
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 Esempio in C:
 
@@ -1018,14 +1025,15 @@ Argomenti:
 * _max_: numero massimo di caratteri da comparare
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 Esempio in C:
 
@@ -1066,14 +1074,15 @@ Argomenti:
 I valori 29 e 30 vengono usati da alcuni protocolli come IRC.
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 Esempio in C:
 
@@ -1116,15 +1125,16 @@ uppercase letters are properly converted to lowercase (by calling function
 `towlower`), in addition to the range `A` to `Z`.
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase if _case_sentitive_ is set to 0) from the last
-compared UTF-8 char in _string1_ (converted to lowercase if _case_sensitive_ is
-set to 0):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase if _case_sentitive_ is set to 0) from the last
+  compared UTF-8 char in _string1_ (converted to lowercase if _case_sensitive_ is
+  set to 0):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 Esempio in C:
 
diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc
index 66d5d5881..4300be134 100644
--- a/doc/ja/weechat_plugin_api.ja.adoc
+++ b/doc/ja/weechat_plugin_api.ja.adoc
@@ -729,13 +729,14 @@ int weechat_string_charcmp (const char *string1, const char *string2);
 * _string2_: 2 番目の比較文字列
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the first UTF-8 char in _string2_
-from the first UTF-8 char in _string1_:
+Return value:
 
+* arithmetic result of subtracting the first UTF-8 char in _string2_
+  from the first UTF-8 char in _string1_:
 // TRANSLATION MISSING
-* < 0 if char1 < char2
-* 0 if char1 == char2
-* > 0 if char1 > char2
+** < 0 if char1 < char2
+** 0 if char1 == char2
+** > 0 if char1 > char2
 
 C 言語での使用例:
 
@@ -772,14 +773,15 @@ int weechat_string_charcasecmp (const char *string1, const char *string2);
 * _string2_: 2 番目の比較文字列
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the first UTF-8 char in _string2_
-(converted to lowercase) from the first UTF-8 char in _string1_ (converted to
-lowercase):
+Return value:
 
+* arithmetic result of subtracting the first UTF-8 char in _string2_
+  (converted to lowercase) from the first UTF-8 char in _string1_ (converted to
+  lowercase):
 // TRANSLATION MISSING
-* < 0 if char1 < char2
-* 0 if char1 == char2
-* > 0 if char1 > char2
+** < 0 if char1 < char2
+** 0 if char1 == char2
+** > 0 if char1 > char2
 
 C 言語での使用例:
 
@@ -811,13 +813,14 @@ int weechat_strcmp (const char *string1, const char *string2);
 * _string2_: 2 番目の比較対象の文字列
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ from the last compared UTF-8 char in _string1_:
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ from the last compared UTF-8 char in _string1_:
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C 言語での使用例:
 
@@ -850,13 +853,14 @@ int weechat_strncmp (const char *string1, const char *string2, int max);
 * _max_: 比較する文字数の最大値
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ from the last compared UTF-8 char in _string1_:
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ from the last compared UTF-8 char in _string1_:
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C 言語での使用例:
 
@@ -894,14 +898,15 @@ int weechat_strcasecmp (const char *string1, const char *string2);
 * _string2_: 2 番目の比較対象の文字列
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C 言語での使用例:
 
@@ -941,14 +946,15 @@ int weechat_strcasecmp_range (const char *string1, const char *string2, int rang
 29 と 30 は IRC など一部のプロトコルで使います。
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C 言語での使用例:
 
@@ -987,14 +993,15 @@ int weechat_strncasecmp (const char *string1, const char *string2, int max);
 * _max_: 比較する文字数の最大値
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C 言語での使用例:
 
@@ -1034,14 +1041,15 @@ int weechat_strncasecmp_range (const char *string1, const char *string2, int max
 29 と 30 は IRC など一部のプロトコルで使います。
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C 言語での使用例:
 
@@ -1083,15 +1091,16 @@ uppercase letters are properly converted to lowercase (by calling function
 `towlower`), in addition to the range `A` to `Z`.
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase if _case_sentitive_ is set to 0) from the last
-compared UTF-8 char in _string1_ (converted to lowercase if _case_sensitive_ is
-set to 0):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase if _case_sentitive_ is set to 0) from the last
+  compared UTF-8 char in _string1_ (converted to lowercase if _case_sensitive_ is
+  set to 0):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C 言語での使用例:
 
diff --git a/doc/sr/weechat_plugin_api.sr.adoc b/doc/sr/weechat_plugin_api.sr.adoc
index 5af4f6974..eb75afef5 100644
--- a/doc/sr/weechat_plugin_api.sr.adoc
+++ b/doc/sr/weechat_plugin_api.sr.adoc
@@ -690,13 +690,14 @@ int weechat_string_charcmp (const char *string1, const char *string2);
 * _string2_: други стринг за поређење
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the first UTF-8 char in _string2_
-from the first UTF-8 char in _string1_:
+Return value:
 
+* arithmetic result of subtracting the first UTF-8 char in _string2_
+  from the first UTF-8 char in _string1_:
 // TRANSLATION MISSING
-* < 0 if char1 < char2
-* 0 if char1 == char2
-* > 0 if char1 > char2
+** < 0 if char1 < char2
+** 0 if char1 == char2
+** > 0 if char1 > char2
 
 C пример:
 
@@ -733,14 +734,15 @@ int weechat_string_charcasecmp (const char *string1, const char *string2);
 * _string2_: други стринг за поређење
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the first UTF-8 char in _string2_
-(converted to lowercase) from the first UTF-8 char in _string1_ (converted to
-lowercase):
+Return value:
 
+* arithmetic result of subtracting the first UTF-8 char in _string2_
+  (converted to lowercase) from the first UTF-8 char in _string1_ (converted to
+  lowercase):
 // TRANSLATION MISSING
-* < 0 if char1 < char2
-* 0 if char1 == char2
-* > 0 if char1 > char2
+** < 0 if char1 < char2
+** 0 if char1 == char2
+** > 0 if char1 > char2
 
 C пример:
 
@@ -774,13 +776,14 @@ int weechat_strcmp (const char *string1, const char *string2);
 Повратна вредност:
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ from the last compared UTF-8 char in _string1_:
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ from the last compared UTF-8 char in _string1_:
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C пример:
 
@@ -813,13 +816,14 @@ int weechat_strncmp (const char *string1, const char *string2, int max);
 * _max_: максимални број карактера који се пореде
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ from the last compared UTF-8 char in _string1_:
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ from the last compared UTF-8 char in _string1_:
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C пример:
 
@@ -859,14 +863,15 @@ int weechat_strcasecmp (const char *string1, const char *string2);
 Повратна вредност:
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C пример:
 
@@ -906,14 +911,15 @@ int weechat_strcasecmp_range (const char *string1, const char *string2, int rang
 Вредности 29 и 30 користе неки протоколи, као што је IRC.
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C пример:
 
@@ -952,14 +958,15 @@ int weechat_strncasecmp (const char *string1, const char *string2, int max);
 * _max_: максимални број карактера који се пореде
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C пример:
 
@@ -998,14 +1005,15 @@ int weechat_strncasecmp_range (const char *string1, const char *string2, int max
 Вредности 29 и 30 користе неки протоколи, као што је IRC.
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
-(converted to lowercase):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase) from the last compared UTF-8 char in _string1_
+  (converted to lowercase):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C пример:
 
@@ -1047,15 +1055,16 @@ uppercase letters are properly converted to lowercase (by calling function
 `towlower`), in addition to the range `A` to `Z`.
 
 // TRANSLATION MISSING
-Return value: arithmetic result of subtracting the last compared UTF-8 char in
-_string2_ (converted to lowercase if _case_sentitive_ is set to 0) from the last
-compared UTF-8 char in _string1_ (converted to lowercase if _case_sensitive_ is
-set to 0):
+Return value:
 
+* arithmetic result of subtracting the last compared UTF-8 char in
+  _string2_ (converted to lowercase if _case_sentitive_ is set to 0) from the last
+  compared UTF-8 char in _string1_ (converted to lowercase if _case_sensitive_ is
+  set to 0):
 // TRANSLATION MISSING
-* < 0 if string1 < string2
-* 0 if string1 == string2
-* > 0 if string1 > string2
+** < 0 if string1 < string2
+** 0 if string1 == string2
+** > 0 if string1 > string2
 
 C пример: