Syntax documentation rewrite for E-commands

Rewrote the syntax documentation for commands starting with the letter
E.

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