the kill protocol

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

2 files changed, 56 insertions, 10 deletions

diff --git a/TODO b/TODO
index ab75805..a40fbe4 100644
--- a/TODO
+++ b/TODO
@@ -9,16 +9,6 @@ Missing servers:
 	cursorshadow	kill		focus		colour
 	state		screensaver
 
-Missing protocols:
-
-	drag		kkbdrate  	keytrans	multikey
-	rat		cursor		colour		state
-	focus		kill		screensaver	compositor
-	crtc		presentation	network		decorator
-	workspace
-	embed		Embedding windows inside other windows such as a status icon tray
-
-
 Extra servers:
 
 	kbdbind		ratbind		gestures	dcvs
@@ -33,6 +23,15 @@ Missing commands:
 	chvt
 	conf		Command line interface for reconfiguring servers
 
+Missing protocols:
+
+	drag		kkbdrate  	keytrans	multikey
+	rat		cursor		colour		state
+	focus		screensaver	compositor	crtc
+	presentation	network		decorator	workspace
+	embed		Embedding windows inside other windows such as a status icon tray
+
+
 Need testing:
 
 	registry
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