NAME

Net::Jabber::X::AutoUpdate - Jabber X AutoUpdate Delegate

SYNOPSIS

Net::Jabber::X::AutoUpdate is a companion to the Net::Jabber::X module.
It provides the user a simple interface to set and retrieve all 
parts of a Jabber X AutoUpdate.

DESCRIPTION

  To initialize the AutoUpdate with a Jabber <x/> you must pass it the 
  XML::Parser Tree array from the module trying to access the <x/>.  
  In the callback function:

    use Net::Jabber;

    sub iq {
      my $foo = new Net::Jabber::Foo(@_);

      my @xTags = $foo->GetX("jabber:x:autoupdate");

      my $xTag;
      foreach $xTag (@xTags) {
	$xTag->....
	
      }
      .
      .
      .
    }

  You now have access to all of the retrieval functions available.

  To create a new AutoUpdate to send to the server:

    use Net::Jabber;

    $foo = new Net::Jabber::Foo();
    $x = $foo->NewX("jabber:x:autoupdate");

  Now you can call the creation functions below.

  For more information about the array format being passed to the CallBack
  please read the Net::Jabber::Client documentation.

Retrieval functions

$jid = $xTag->GetJID();

Creation functions

$xTag->SetX(jid=>"update.jabber.org");

$xTag->SetJID("update.jabber.com");

METHODS

Retrieval functions

GetJID() - returns a string with the Jabber Identifier of the 
           agent that is going to handle the update.

Creation functions

SetX(jid=>string) - set multiple fields in the <x/> at one
                    time.  This is a cumulative and over
                    writing action.  If you set the "jid"
                    attribute twice, the second setting is
                    what is used.  For valid settings read the
                    specific Set functions below.

SetJID(string) - sets the JID of the agent that is going to handle the
                 update.

AUTHOR

By Ryan Eatmon in May of 2000 for http://jabber.org..

COPYRIGHT

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.