Subject: Commit in docs/usefor (usepro.xml)

From: [email-masked]
Date: Mon, 19 Feb 2007 22:22:33 -0800 (PST)

Date: Monday, February 19, 2007 @ 22:22:32
  Author: eagle
Revision: 2817

Resolve #1413.  Make the relayer-name parameter to the ihave and sendme
control messages required, matching Son-of-1036.

Modified:
  docs/usefor/usepro.xml

Modified: docs/usefor/usepro.xml
===================================================================
--- docs/usefor/usepro.xml	2007-02-20 06:16:02 UTC (rev 2816)
+++ docs/usefor/usepro.xml	2007-02-20 06:22:32 UTC (rev 2817)
@@ -1791,8 +1791,7 @@
           <artwork>
       control-command     =/ Ihave-command
       Ihave-command       = "ihave" Ihave-arguments
-      Ihave-arguments     = 1*WSP relayer-name
-                            / 1*( 1*WSP msg-id ) [ 1*WSP relayer-name ]
+      Ihave-arguments     = 1*WSP *( msg-id 1*WSP ) relayer-name
       control-command     =/ Sendme-command
       Sendme-command      = "sendme" Sendme-arguments
       Sendme-arguments    = Ihave-arguments
@@ -1815,8 +1814,9 @@
         may be of interest to the relaying agents receiving the ihave
         message.  The sendme message requests that the agent receiving it
         send the articles having the specified message identifiers to the
-        named relaying agent.  If &lt;relayer-name> is not given, it is
-        determined from the origin of the control message.</t>
+        named relaying agent.  Contrary to <xref target="RFC1036" />, the
+        relayer-name MUST be given as the last argument in the Control
+        header field.</t>
 
         <t>Upon receipt of the sendme message (and a decision to honor
         it), the receiving agent sends the article or articles requested.
@@ -2092,6 +2092,9 @@
           <t>Cancel control messages are no longer required to have From
           and Sender header fields matching those of the target message,
           as this requirement added no real security.</t>
+
+          <t>The relayer-name parameter in the Control header field of
+          ihave and sendme control messages is now required.</t>
         </list>
       </t>