core: add options "setvar" and "delvar" in command /buffer, rename option "localvar" to "listvar"

The option "localvar" (introduced long time ago, in WeeChat 0.3.0) is still
recognized by WeeChat, to stay compatible with any extension/script calling
it (or referencing it in the documentation).

It is deprecated and will be removed in a future release.

4 files changed, 55 insertions, 47 deletions

diff --git a/doc/de/includes/autogen_api_completions.de.adoc b/doc/de/includes/autogen_api_completions.de.adoc
index b1e76cfdb..c4f71190d 100644
--- a/doc/de/includes/autogen_api_completions.de.adoc
+++ b/doc/de/includes/autogen_api_completions.de.adoc
@@ -120,6 +120,10 @@
 
 | weechat | bars_options | Einstellungen für Infobars
 
+| weechat | buffer_local_variable_value | value of a buffer local variable
+
+| weechat | buffer_local_variables | buffer local variables
+
 | weechat | buffer_properties_get | Eigenschaften die für den Buffer gelesen werden können
 
 | weechat | buffer_properties_set | Eigenschaften die für den Buffer gesetzt werden können
diff --git a/doc/de/includes/autogen_user_commands.de.adoc b/doc/de/includes/autogen_user_commands.de.adoc
index 8a9fb750d..136acac17 100644
--- a/doc/de/includes/autogen_user_commands.de.adoc
+++ b/doc/de/includes/autogen_user_commands.de.adoc
@@ -1022,7 +1022,7 @@ Anmerkung: Im Befehl können Variablen genutzt werden, die dann durch den entspr
       $n-m: Argumente von 'n' bis 'm'
         $*: alle Argumente
         $~: letztes Argument
-      $var: "var" ist eine lokale Variable für den jeweiligen Buffer (siehe /buffer localvar)
+      $var: "var" ist eine lokale Variable für den jeweiligen Buffer (siehe /buffer listvar)
             Beispiel: $nick, $channel, $server, $plugin, $name
 
 Beispiele:
@@ -1115,67 +1115,71 @@ Beispiele:
          renumber [<number1> [<number2> [<start>]]]
          close [<n1>[-<n2>]|<name>...]
          notify [<level>]
-         localvar [<number>|<name>]
+         listvar [<number>|<name>]
+         setvar <name> [<value>]
+         delvar <name>
          set <property> [<value>]
          get <property>
          <number>|-|+|<name>
 
-    list: alle geöffneten Buffer werden aufgelistet (ohne Angabe von Argumente wird diese Liste standardmäßig ausgegeben)
-     add: öffnet einen neuen Buffer (dieser kann mit "/buffer close" oder "q" in der Eingabezeile, beendet werden)
-   clear: leert den Inhalt des Buffers (entweder durch Angabe der entsprechenden Nummer des Buffers oder "-merged " für zusammengefügte Buffer oder "-all" für alle Buffer. Ohne Angabe eines Arguments wird der aktuelle Buffer gelöscht)
-    move: Buffer in der Liste verschieben (kann auch relativ sein, z.B. -1); "-" = auf erste Position verschieben, "+" = auf letzte Position + 1 verschieben
-    swap: tauscht zwei Buffer miteinander aus (bei Angabe von nur einem Buffer (Buffernummer/-name), wird der aktuelle Buffer mit dem angegebenen Buffer getauscht)
-   cycle: springt in einer Schleife von einem Buffer zum nächsten, die in einer Liste angegeben werden
-   merge: fügt den aktuellen Buffer mit einem anderen Buffer zusammen (bei einem Chat-Buffer werden zwei Buffer zusammengefügt
-         (Bei der Standardtastenbelegung wird mittels "CTRL-x" zwischen zusammengefügten Buffern umgeschaltet)
- unmerge: trennt Buffer wieder voneinander, falls zwei Buffer die selbe Nummer teilen
-    hide: versteckt einen Buffer
-  unhide: macht Buffer wieder sichtbar
-renumber: Buffer werden umnummeriert (Einstellung weechat.look.buffer_auto_renumber muss deaktiviert sein)
-   close: Buffer schließen (Nummer oder Bereich ist optional)
-  notify: Benachrichtigungsstufe für den aktuellen Buffer anzeigen oder einstellen. Folgende Möglichkeiten bestimmen den Grad der Benachrichtigung und ob der Buffer in der Hotlist angezeigt wird:
-            none: keine Benachrichtigung
-       highlight: Benachrichtigung bei hervorgehobenen Nachrichten (Highlights)
-         message: Benachrichtigung bei Nachrichten von Usern + Highlights
-             all: Benachrichtigung bei allen Nachrichten
-           reset: Benachrichtigung auf Standardwert zurück setzen (all)
-localvar: zeigt die lokalen Variablen für den aktuellen Buffer an
-     set: setzt eine Eigenschaft für den aktuellen Buffer
-     get: zeigt eine Eigenschaft für den aktuellen Buffer an
-  number: wechselt von einem Buffer zu einem anderen, mögliche Optionen:
-          '+': relativer Sprung um 'n'-Buffer
-          '-': relativer Sprung, um 'n'-Buffer
-          '*': wechselt zum Buffer mit der Nummer 'n'; nutzt die interne Einstellung "weechat.look.jump_current_to_previous_buffer"
-       -: springt zum ersten Buffer
-       +: springt zum letzten Buffer
-    name: wechselt zum Buffer mit dem angegebenen Namen (Name muss nicht vollständig sein!)
+    list: list buffers (without argument, this list is displayed)
+     add: add a new buffer (it can be closed with "/buffer close" or input "q")
+   clear: clear buffer content (number for a buffer, -merged for merged buffers, -all for all buffers, or nothing for current buffer)
+    move: move buffer in the list (may be relative, for example -1); "-" = move to first buffer number, "+" = move to last buffer number + 1
+    swap: swap two buffers (swap with current buffer if only one number/name given)
+   cycle: jump loop between a list of buffers
+   merge: merge current buffer to another buffer (chat area will be mix of both buffers)
+          (by default ctrl-x switches between merged buffers)
+ unmerge: unmerge buffer from other buffers which have same number
+    hide: hide the buffer
+  unhide: unhide the buffer
+renumber: renumber buffers (works only if option weechat.look.buffer_auto_renumber is off)
+   close: close buffer (number/range or name is optional)
+  notify: display or set notify level for current buffer: this level determines whether buffer will be added to hotlist or not:
+               none: never
+          highlight: for highlights only
+            message: for messages from users + highlights
+                all: all messages
+              reset: reset to default value (all)
+ listvar: display local variables in a buffer
+  setvar: set a local variable in the current buffer
+  delvar: delete a local variable from the current buffer
+     set: set a property in the current buffer
+     get: display a property of current buffer
+  number: jump to buffer by number, possible prefix:
+          '+': relative jump, add number to current
+          '-': relative jump, sub number to current
+          '*': jump to number, using option "weechat.look.jump_current_to_previous_buffer"
+       -: jump to first buffer number
+       +: jump to last buffer number
+    name: jump to buffer by (partial) name
 
-Beispiele:
-  leert den aktuellen Buffer:
+Examples:
+  clear current buffer:
     /buffer clear
-  verschiebt Buffer auf Position 5:
+  move buffer to number 5:
     /buffer move 5
-  tauscht Buffer 1 und 3:
+  swap buffer 1 with 3:
     /buffer swap 1 3
-  tauscht Buffer #weechat und den aktuellen Buffer:
+  swap buffer #weechat with current buffer:
     /buffer swap #weechat
-  springt in einer Schleife zu den Buffern #chan1, #chan2, #chan3:
+  jump on #chan1, #chan2, #chan3 and loop:
     /buffer cycle #chan1 #chan2 #chan3
-  verbindet Buffer mit dem Core-Buffer:
+  merge with core buffer:
     /buffer merge 1
-  verbindet Buffer mit #weechat buffer:
+  merge with #weechat buffer:
     /buffer merge #weechat
-  trennt Buffer voneinander:
+  unmerge buffer:
     /buffer unmerge
-  schließt aktuellen Buffer:
+  close current buffer:
     /buffer close
-  schließt Buffer 5 bis 7:
+  close buffers 5 to 7:
     /buffer close 5-7
-  springt zum Buffer: #weechat:
+  jump to #weechat:
     /buffer #weechat
-  springt zum nächsten Buffer:
+  jump to next buffer:
     /buffer +1
-  springt zum letzten Buffer:
+  jump to last buffer number:
     /buffer +
 ----
 
diff --git a/doc/de/weechat_scripting.de.adoc b/doc/de/weechat_scripting.de.adoc
index 3f1921a21..c4ea922e7 100644
--- a/doc/de/weechat_scripting.de.adoc
+++ b/doc/de/weechat_scripting.de.adoc
@@ -988,7 +988,7 @@ Um zu sehen welche lokalen Variablen für einen Buffer gesetzt sind führen Sie
 bitte in WeeChat folgenden Befehl aus:
 
 ----
-/buffer localvar
+/buffer listvar
 ----
 
 [[hooks]]
diff --git a/doc/de/weechat_user.de.adoc b/doc/de/weechat_user.de.adoc
index 44d97fa8e..20b65575c 100644
--- a/doc/de/weechat_user.de.adoc
+++ b/doc/de/weechat_user.de.adoc
@@ -3150,7 +3150,7 @@ mit lokalen Buffervariablen zu füllen. Um sich die verfügbaren lokalen Variabl
 für den aktuellen Buffer anzeigen zu lassen:
 
 ----
-/buffer localvar
+/buffer listvar
 ----
 
 Masken werden in absteigender Reihenfolge abgeglichen, beginnend mit