From 481fdeae429362c7344445a1a1e0b6cd65b00dba Mon Sep 17 00:00:00 2001
From: Mark Taylor <m.b.taylor@bristol.ac.uk>
Date: Wed, 26 Oct 2011 12:25:44 +0000
Subject: [PATCH] replace MessageSender -target flag with -targetid and
 -targetname

git-svn-id: file:///mbt/data/jsamp/svn-mirror/trunk/astrogrid/samp@27294 d07e2994-6e00-4123-b050-8522f38abc7a
---
 src/site/xdoc/commands.xml | 23 +++++++++++++++++++----
 src/site/xdoc/history.xml  |  3 +++
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/src/site/xdoc/commands.xml b/src/site/xdoc/commands.xml
index 37f03e7..a4ecb37 100644
--- a/src/site/xdoc/commands.xml
+++ b/src/site/xdoc/commands.xml
@@ -446,10 +446,25 @@ any responses received in response.
     if possible (note double-quoted strings are the only permitted scalars),
     otherwise the value will be interpreted as a plain string.
     </dd>
-<dt><code>-target &lt;receiverId&gt;</code></dt>
-<dd>Specifies the SAMP public ID for a client to which this message will be
-    sent.  This flag may be repeated to send the same messsage to more than
-    one recipient.  If omitted, the message is <em>broadcast</em> to all
+<dt><code>-targetid &lt;receiverId&gt;</code></dt>
+<dd>Specifies the SAMP public ID for a client to which this message
+    will be sent.
+    This flag may be repeated, or combined with <code>-targetname</code>,
+    to send the same messsage to more than one recipient.
+    If neither this nor <code>-targetname</code> is supplied,
+    the message is <em>broadcast</em> to all
+    clients which are subscribed to the MType.
+    </dd>
+<dt><code>-targetname &lt;receiverName&gt;</code></dt>
+<dd>Specifies an application name (<code>samp.name</code> metadata item)
+    identifying a client to which this message will be sent.
+    Names are matched case-insensitively.
+    If multiple clients with the same name are registered, only one
+    will be messaged.
+    This flag may be repeated, or combined with <code>-targetid</code>,
+    to send the same messsage to more than one recipient.
+    If neither this nor <code>-targetid</code> is supplied,
+    the message is <em>broadcast</em> to all
     clients which are subscribed to the MType.
     </dd>
 <dt><code>-mode sync|async|notify</code></dt>
diff --git a/src/site/xdoc/history.xml b/src/site/xdoc/history.xml
index a39ad15..e43408c 100644
--- a/src/site/xdoc/history.xml
+++ b/src/site/xdoc/history.xml
@@ -771,6 +771,9 @@ for SAMP objects in a few places:
 <li>Tone down warning in the Web SAMP confirmation dialogue slightly
     to reflect improved security measures in default Web Profile
     configuration.</li>
+<li>The <code>messagesender</code> command-line tool has new flags
+    <code>-targetname</code> and <code>-targetid</code> which replace the
+    previous <code>-target</code> flag.</li>
 <li>Add French translation for Web SAMP confirmation dialogue
     (thanks to Thomas Boch).</li>
 <li>URL encode argument of <code>ResourceHandler.addResource</code>