diff options
author | Geert Hauwaerts <geert@hauwaerts.be> | 2014-07-03 21:42:37 +0200 |
---|---|---|
committer | Geert Hauwaerts <geert@hauwaerts.be> | 2014-07-03 21:42:37 +0200 |
commit | f295a02cdafff01d7b7161f62bf8a2327fbb10fa (patch) | |
tree | b51e93b068ed2931cba35e89dba33ea54eb8e170 /docs | |
parent | 037fae0ed567eedefe5550d0688cf5b42a53b6c7 (diff) | |
download | irssi-f295a02cdafff01d7b7161f62bf8a2327fbb10fa.zip |
Syntax documentation rewrite for E-commands
Rewrote the syntax documentation for commands starting with the letter
E.
Diffstat (limited to 'docs')
-rw-r--r-- | docs/help/in/echo.in | 22 | ||||
-rw-r--r-- | docs/help/in/eval.in | 23 | ||||
-rw-r--r-- | docs/help/in/exec.in | 82 |
3 files changed, 87 insertions, 40 deletions
diff --git a/docs/help/in/echo.in b/docs/help/in/echo.in index 0a70e354..a730e282 100644 --- a/docs/help/in/echo.in +++ b/docs/help/in/echo.in @@ -1,5 +1,25 @@ +%9Syntax:%9 + @SYNTAX:echo@ -Prints text into the current window. Useful for scripts. +%9Parameters:%9 + + -current: Displays the output in the active window. + -window: Displays the ouput in the target window. + -level: Displays the output with a given message level. + + The text ouput; if no target is given, the active window will be used. + +%9Description:%9 + + Displays the given text. + +%9Examples:%9 + + /ECHO 1 + 1 = 2 :D + /ECHO -current Testing the ECHO command + /ECHO -window #irssi Special variables such as ${N} will not be expanded. + +%9See also:%9 CAT, EVAL, EXEC, LEVELS diff --git a/docs/help/in/eval.in b/docs/help/in/eval.in index 8ea0652a..74a0c536 100644 --- a/docs/help/in/eval.in +++ b/docs/help/in/eval.in @@ -1,6 +1,25 @@ +%9Syntax:%9 + @SYNTAX:eval@ -Evaluates the given commands and executes them. Internal variables -are expanded. See the special_vars.txt file in the docs-directory. +%9Parameters:%9 + + The commands to evaluate. + +%9Description:%9 + + Evaluates the given commands and executes them; you can use internal + variables and separate multiple commands by using the ";" character. + +%9Examples%9 + + /EVAL echo I am connected to ${S} on ${chatnet} as ${N} + /EVAL echo My user privileges are +${usermode}; echo Let's party! + +%9References:%9 + + https://github.com/irssi/irssi/blob/master/docs/special_vars.txt + +%9See also:%9 CAT, CD, ECHO, EXEC diff --git a/docs/help/in/exec.in b/docs/help/in/exec.in index 7b092868..f12d7dcc 100644 --- a/docs/help/in/exec.in +++ b/docs/help/in/exec.in @@ -1,41 +1,49 @@ +%9Syntax:%9 + @SYNTAX:exec@ - -: Don't print "process terminated ..." message - -nosh: Don't start command through /bin/sh - -out: Send output to active channel/query - -msg: Send output to specified nick/channel - -notice: Send output to specified nick/channel as notices - -name: Name the process so it could be accessed easier - - -window: Move the output of specified process to active window - -close: Forcibly close (or "forget") a process that doesn't die. - This only removes all information from irssi concerning the - process, it doesn't send SIGKILL or any other signal - to the process. - -<signal>: Send a signal to process. <signal> can be either numeric - or one of the few most common ones (hup, term, kill, ...) - - -in: Send text to standard input of the specified process - -interactive: Creates a query-like window item. Text written to it is - sent to executed process, like /EXEC -in. - -Execute specified command in background. Output of process is printed -to active window by default, but can be also sent as messages or -notices to specified nick or channel. - -Processes can be accessed either by their ID or name if you named it. -Process identifier must always begin with '%%' character, like %%0 or -%%name. - -Once the process is started, its output can still be redirected -elsewhere with the -window, -msg, etc. options. You can send text to -standard input of the process with -in option. - --close option shouldn't probably be used if there's a better way to -kill the process. It is meant to remove the processes that don't die -even with SIGKILL. This option just closes the pipes used to -communicate with the process and frees all memory it used. - -EXEC without any arguments displays the list of started processes. +%9Parameters:%9 + + -: Suppresses the process termination notification. + -nosh: Doesn't execute the command through /bin/sh. + -out: Sends the output to the active channel or query. + -msg: Sends the output to the specified nickname or channel. + -notice: Sends the output to the specified nickname or channel as notices. + -name: Gives the process the specified name. + -window: Displays the output in the active window. + -close: Forcibly closes a process that doesn't die. + -<signal>: Sends the given signal to the process. + -in: Sends text to the standard input of the process. + -interactive: Executes the process in a new window item. + + The command to execute; if no output parameter is given, the active window + will be used and if no parameters are given at all, the list of active + processes will be displayed. + +%9Description:%9 + + Executes the specified command in the background; the process can be + accessed by its id or the name you gave it. + + The output of the process can be redirected to various targets, such as + a window, a channel, a nickname or a query. + + The process identifier must always begin with the "%%" character. For + example %%0. + + If you remove a process with the close parameter, it will only make Irssi + detach from it; the process will keep running until it terminates. + +%9Examples:%9 + + /EXEC + /EXEC ls + /EXEC -msg #irssi cat unicorn.txt + /EXEC -out cat /etc/passwd | grep $USER | awk -F: '{print $5}' + /EXEC -name mailserver -interactive telnet gmail.google.com. 25 + /EXEC -close mailserver + /EXEC -close %%0 + +%9See also:%9 CAT, CD, ECHO, EVAL |