diff --git a/xep-0060.xml b/xep-0060.xml index 62a4463e..980871ce 100644 --- a/xep-0060.xml +++ b/xep-0060.xml @@ -49,7 +49,7 @@ &ralphm; - 1.12pre2 + 1.12pre3 in progress, last updated 2008-07-02 psa @@ -60,6 +60,7 @@
  • Corrected syntax for associating with and disassociating from a collection node so that it is possible to perform these tasks in relation to the root collection node.
  • Added note about ignoring delivery options set for configuration of a collection node and instead applying delivery options as configured for the publishing leaf node.
  • Defined handling of collection node deletion for various deployment scenarios.
  • +
  • Defined pubsub#notify_sub config option so that owners can receive notifications of new subscriptions, unsubscribes, and other subscription changes.
  • @@ -1436,7 +1437,7 @@ And by opposing end them?

    An entity may wish to subscribe using different subscription options, which it can do by subscribing multiple times to the same node. Support for this feature ("multi-subscribe") is OPTIONAL.

    If multiple subscriptions for the same JID are allowed, the service MUST use the 'subid' attribute to differentiate between subscriptions for the same entity (therefore the SubID MUST be unique for each node+JID combination and the SubID MUST be present on the entity element any time it is sent to the subscriber). It is NOT RECOMMENDED for clients to generate SubIDs, since collisions might result; therefore a service SHOULD generate the SubID on behalf of the subscriber and MAY overwrite SubIDs if they are provided by subscribers. If the service does not allow multiple subscriptions for the same entity and it receives an additional subscription request, the service MUST return the current subscription state (as if the subscription was just approved).

    - +

    When a subscription request is successfully processed, the service MAY send the last published item to the new subscriber. The message containing this item SHOULD be stamped with extended information qualified by the 'urn:xmpp:delay' namespace (see &xep0203;) to indicate it is sent with delayed delivery. (Note that in this example the message notification is sent to the bare JID since that is the subscribed JID.)

    @@ -3285,6 +3286,7 @@ And by opposing end them? 0 0 0 + 0 1028 http://www.w3.org/2005/Atom @@ -3354,6 +3356,10 @@ And by opposing end them? label='Notify subscribers when items are removed from the node'> false + + 0 + 1 @@ -3537,6 +3543,7 @@ And by opposing end them? 0 0 0 + 0 1028 http://www.w3.org/2005/Atom @@ -3610,6 +3617,7 @@ And by opposing end them? 0 0 0 + 0 1 10 1 @@ -3679,6 +3687,10 @@ And by opposing end them? label='Notify subscribers when items are removed from the node'> 0 + + 0 + 1 @@ -4494,13 +4506,37 @@ And by opposing end them?

    In order to remove an entity from the subscriptions list, the owner MUST set the value of the 'subscription' attribute to "none" and the service MUST remove that entity from the subscriptions list and not return it in response to future list requests.

    - +

    An implementation SHOULD send notification to an entity whose subscription has changed (see the Notification of Subscription State Changes section of this document).

    + + ]]> +
    + +

    If the node is configured to support the "pubsub#notify_sub" option, the service MUST send to the node owners notifications regarding new subscribers, SHOULD send notifications regarding unsubscribe actions, and MAY send notifications regarding other subscription changes. The relationship between these notifications and the retrieval of the subscriptions list as described under Retrieve Subscriptions List is similar to the relationship between a "roster get" and a "roster push" as described in &xmppim;.

    +

    In particular, the notification consists of a &MESSAGE; stanza containing a <pubsub/> element qualified by the 'http://jabber.org/protocol/pubsub#owner' namespace, which contains a <subscriptions/>l element whose 'node' attribute specifies the NodeID of the relevant node; this <subscriptions/> element in turn contains one <subscription/> element whose 'jid' attribute specifies the address of the subscriber and whose 'subscription' attribute specifies the suubscription state.

    +

    For instance, the following example shows a new subscriber notification.

    + + + + + + + + ]]> +

    The following example shows an unsubscribe notification.

    + + + + + + ]]>
    @@ -6801,6 +6837,9 @@ O, what a rogue and peasant slave am I! +