the kill protocol

Signed-off-by: Mattias Andrée <maandree@operamail.com>

1 files changed, 47 insertions, 0 deletions

diff --git a/doc/info/mds.texinfo b/doc/info/mds.texinfo
index b3e5e97..d514230 100644
--- a/doc/info/mds.texinfo
+++ b/doc/info/mds.texinfo
@@ -3482,6 +3482,7 @@ or @command{Command: get-gamma}.
 
 @menu
 * echo::                            Echo back a message.
+* kill::                            The window killing protocol.
 @end menu
 
 
@@ -3521,6 +3522,52 @@ Recommended for network enabled servers.
 
 
 
+@node kill
+@subsection kill
+
+@table @asis
+@item Identifying header:
+@command{Command: kill}
+
+@item Action:
+Kill and identify processes based on the their windows.
+
+@item Required header: @code{Client ID}
+Your ID, provided by the @code{ID assignment} header
+in response to a @code{Command: assign-id} header.
+
+@item Required header: @code{Window ID}
+The ID of the window whose owning process should
+be identified or signaled.
+
+@item Required header: @code{Signal}
+A numerical value of the signal to send to the
+process. It is up to networking protocols to
+translate these numbers of the display spans
+multiple operating systems. The signal zero
+can usually be used if no signal is to be sent,
+this is however dependent on he operating system.
+
+@item Response:
+The server will respond with a
+@command{Command: error} message.
+In this message the server all include an
+ad-hoc header: @code{Process ID}. Its value
+will be the ID of the process that owns the
+window.
+
+@item Purpose:
+Identify and send signal to processes by refering
+to them by one of their windows.
+
+@item Compulsivity:
+Optional.
+
+@item Reference implementation:
+@command{mds-echo}
+@end table
+
+
 
 @node libmdsserver
 @chapter libmdsserver