exec: add option "-oerr" to send stderr to buffer (now disabled by default) (closes #1566)

1 files changed, 51 insertions, 50 deletions

diff --git a/doc/de/includes/autogen_user_commands.de.adoc b/doc/de/includes/autogen_user_commands.de.adoc
index b2fe7ecd8..46aab098b 100644
--- a/doc/de/includes/autogen_user_commands.de.adoc
+++ b/doc/de/includes/autogen_user_commands.de.adoc
@@ -2175,7 +2175,7 @@ charset: wähle neuen Zeichensatz für aktuellen Buffer
 
 ----
 /exec  -list
-       [-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-n|-nf] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
+       [-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <name>] [-l|-o|-oc|-n|-nf] [-oerr] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] [-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <timeout>] [-name <name>] [-pipe <command>] [-hsignal <name>] <command>
        -in <id> <text>
        -inclose <id> [<text>]
        -signal <id> <signal>
@@ -2184,55 +2184,56 @@ charset: wähle neuen Zeichensatz für aktuellen Buffer
        -set <id> <property> <value>
        -del <id>|-all [<id>...]
 
-   -list: zeigt laufende Befehle an
-     -sh: es wird die shell verwendet um Befehle auszuführen, mehrere Befehle können dabei gepiped werden (WARNUNG: Dieses Argument sollte nur verwendet werden, falls alle Argumente unbedenklich sind, siehe Argument -nosh)
-   -nosh: die shell wird nicht verwendet um Befehle auszuführen (wird benötigt, falls der Befehl mit sensiblen Daten hantiert. Zum Beispiel der Inhalt einer Nachricht eines anderen Users)(Standardverhalten)
-     -bg: führt Prozess im Hintergrund aus: es wird weder eine Prozessausgabe noch ein Rückgabewert ausgegeben (nicht kompatibel mit Argumenten -o/-oc/-n/-nf/-pipe/-hsignal)
-   -nobg: gibt Prozessausgabe und Rückgabewert aus (Standardverhalten)
-  -stdin: erstellt eine PIPE um Daten zu dem Prozess zu senden (mittels /exec -in/-inclose)
--nostdin: es wird keine PIPE für stdin erstellt (Standardverhalten)
- -buffer: zeigt/sendet Ausgabe des Befehls an diesen Buffer (wird der angegebene Buffer nicht gefunden wird ein neuer Buffer mit dem Namen "exec.exec.xxx" erstellt)
-      -l: gibt die Ausgabe des Befehls lokal im Buffer aus (Standardverhalten)
-      -o: gibt die Ausgabe des Befehls im Buffer aus (nicht kompatibel mit Argumenten -bg/-pipe/-hsignal)
-     -oc: gibt die Ausgabe des Befehls im Buffer aus und führt diesen dann aus (betrifft Zeilen die mit "/" beginnen bzw. das benutzerdefinierte Befehlszeichen verwenden) (nicht kompatibel mit Argumenten -bg/-pipe/-hsignal)
-      -n: gibt die Ausgabe des Befehls in einem neuen Buffer aus (nicht kompatibel mit Argumenten -bg/-pipe/-hsignal)
-     -nf: gibt die Ausgabe des Befehls in einem neuen Buffer, mit einem freien Inhalt, aus (kein Zeilenumbruch, keine Limitierung in der Anzahl der Zeilen), aus (nicht kompatibel mit Argument -bg/-pipe/-hsignal)
-     -cl: der neue Buffer wird vor einer Ausgabe gelöscht
-   -nocl: Ausgabe wird an neuen Buffer angehangen, ohne diesen vorher zu löschen (Standardverhalten)
-     -sw: es wird zum Ausgabebuffer gewechselt (Standardverhalten)
-   -nosw: es wird nicht zum Ausgabebuffer gewechselt
-     -ln: legt eine Zeilennummerierung an (Standardverhalten, nur für neue Buffer)
-   -noln: es wird keine Zeilennummerierung angezeigt
-  -flush: die Ausgabe des Befehls findet in Echtzeit statt (Standardwert)
--noflush: die Ausgabe des Befehls wird am Ende der Ausführung ausgegeben
-  -color: es wird eine der folgenden Aktionen bei ANSI Zeichenkodierungen in der Ausgabe durchgeführt:
-             ansi: ANSI-Kodierung wird beibehalten
-             auto: konvertiert ANSI-Farben nach WeeChat/IRC (Standardverhalten)
-              irc: konvertiert ANSI-Farben nach IRC Farben
-          weechat: konvertiert ANSI-Farben nach WeeChat-Farben
-            strip: ANSI-Farben werden entfernt
-     -rc: der Rückgabewert wird ausgegeben (Standardverhalten)
-   -norc: der Rückgabewert wird unterdrückt
--timeout: gibt eine Zeitbeschränkung für den auszuführenden Befehl an (in Sekunden)
-   -name: dem Befehl wird ein Name zugewiesen (um den Befehl später mittels /exec zu nutzen)
-   -pipe: sendet die Ausgabe an einen Befehl von WeeChat/Erweiterung (Zeile für Zeile); sollen Leerzeichen im Befehl/Argument verwendet werden, müssen diese mit Anführungszeichen eingeschlossen werden; Variable $line wird durch die entsprechende Zeile ersetzt (standardmäßig wird die Zeile, getrennt durch ein Leerzeichen, dem Befehl nachgestellt (nicht kompatibel mit den Argumenten -bg/-o/-oc/-n/-nf)
- -hsignal: sendet die Ausgabe als hsignal (um es z.B. mittels /trigger zu verwenden) (nicht kompatibel mit den Argumenten -bg/-o/-oc/-n/-nf)
- command: Befehl der ausgeführt werden soll; beginnt der Befehl mit "url:", wird die shell deaktiviert und der Inhalt der URL wird heruntergeladen und im Buffer ausgegeben
-      id: identifiziert eindeutig einen Befehl: entweder durch eine Nummer oder einen Namen (sofern ein Name mittels "-name xxx" zugewiesen wurde)
-     -in: sendet Text an die Standardeingabe des Prozesses
--inclose: wie -in aber stdin wird danach geschlossen (und der Text ist optional: ohne Text wird stdin umgehend geschlossen
- -signal: schickt ein Signal an den Prozess; das Signal kann entweder ein Integerwert oder eines der folgenden Schlüsselworte sein: hup, int, quit, kill, term, usr1, usr2
-   -kill: Alias für "-signal <id> kill"
--killall: beendet alle laufenden Prozesse
-    -set: nutzt eine Hook-Fähigkeit (siehe Funktion hook_set in Anleitung für API Erweiterung)
-property: Hook-Fähigkeit
-   value: neuer Wert für Hook-Fähigkeit
-    -del: entfernt einen beendeten Befehl
-    -all: entfernt alle beendeten Befehle
-
-Standardoptionen können in der Einstellung exec.command.default_options bestimmt werden.
-
-Beispiele:
+   -list: list commands
+     -sh: use the shell to execute the command, many commands can be piped (WARNING: use this option ONLY if all arguments are safe, see option -nosh)
+   -nosh: do not use the shell to execute the command (required if the command has some unsafe data, for example the content of a message from another user) (default)
+     -bg: run process in background: do not display process output neither return code (not compatible with options -o/-oc/-n/-nf/-pipe/-hsignal)
+   -nobg: catch process output and display return code (default)
+  -stdin: create a pipe for sending data to the process (with /exec -in/-inclose)
+-nostdin: do not create a pipe for stdin (default)
+ -buffer: display/send output of command on this buffer (if the buffer is not found, a new buffer with name "exec.exec.xxx" is created)
+      -l: display locally output of command on buffer (default)
+      -o: send output of command to the buffer without executing commands (not compatible with options -bg/-pipe/-hsignal)
+     -oc: send output of command to the buffer and execute commands (lines starting with "/" or another custom command char) (not compatible with options -bg/-pipe/-hsignal)
+      -n: display output of command in a new buffer (not compatible with options -bg/-pipe/-hsignal)
+     -nf: display output of command in a new buffer with free content (no word-wrap, no limit on number of lines) (not compatible with options -bg/-pipe/-hsignal)
+   -oerr: also send stderr (error output) to the buffer (can be used only with options -o and -oc)
+     -cl: clear the new buffer before displaying output
+   -nocl: append to the new buffer without clear (default)
+     -sw: switch to the output buffer (default)
+   -nosw: don't switch to the output buffer
+     -ln: display line numbers (default in new buffer only)
+   -noln: don't display line numbers
+  -flush: display output of command in real time (default)
+-noflush: display output of command after its end
+  -color: action on ANSI colors in output:
+             ansi: keep ANSI codes as-is
+             auto: convert ANSI colors to WeeChat/IRC (default)
+              irc: convert ANSI colors to IRC colors
+          weechat: convert ANSI colors to WeeChat colors
+            strip: remove ANSI colors
+     -rc: display return code (default)
+   -norc: don't display return code
+-timeout: set a timeout for the command (in seconds)
+   -name: set a name for the command (to name it later with /exec)
+   -pipe: send the output to a WeeChat/plugin command (line by line); if there are spaces in command/arguments, enclose them with double quotes; variable $line is replaced by the line (by default the line is added after the command, separated by a space) (not compatible with options -bg/-o/-oc/-n/-nf)
+-hsignal: send the output as a hsignal (to be used for example in a trigger) (not compatible with options -bg/-o/-oc/-n/-nf)
+ command: the command to execute; if beginning with "url:", the shell is disabled and the content of URL is downloaded and sent as output
+      id: command identifier: either its number or name (if set with "-name xxx")
+     -in: send text on standard input of process
+-inclose: same as -in, but stdin is closed after (and text is optional: without text, the stdin is just closed)
+ -signal: send a signal to the process; the signal can be an integer or one of these names: hup, int, quit, kill, term, usr1, usr2
+   -kill: alias of "-signal <id> kill"
+-killall: kill all running processes
+    -set: set a hook property (see function hook_set in plugin API reference)
+property: hook property
+   value: new value for hook property
+    -del: delete a terminated command
+    -all: delete all terminated commands
+
+Default options can be set in the option exec.command.default_options.
+
+Examples:
   /exec -n ls -l /tmp
   /exec -sh -n ps xu | grep weechat
   /exec -n -norc url:https://pastebin.com/raw.php?i=xxxxxxxx