SYNOPSIS

use Debbugs::User qw(is_valid_user read_usertags write_usertags);

Debbugs::User::is_valid_user($userid);

$u = Debbugs::User::open($userid); $u = Debbugs::User::open(user => $userid, locked => 0);

$u = Debbugs::User::open(user => $userid, locked => 1); $u->write();

$u->{``tags''} $u->{``categories''} $u->{``is_locked''} $u->{``name''}

read_usertags(\%ut, $userid); write_usertags(\%ut, $userid);

USERTAG FILE FORMAT

Usertags are in a file which has (roughly) RFC822 format, with stanzas separated by newlines. For example:

 Tag: search
 Bugs: 73671, 392392
 
 Value: priority
 Bug-73671: 5
 Bug-73487: 2
 
 Value: bugzilla
 Bug-72341: http://bugzilla/2039471
 Bug-1022: http://bugzilla/230941
 
 Category: normal
 Cat1: status
 Cat2: debbugs.tasks
 
 Category: debbugs.tasks
 Hidden: yes
 Cat1: debbugs.tasks
 Cat1Options:
  tag=quick
  tag=medium
  tag=arch
  tag=not-for-me

EXPORT TAGS

:all --- all functions that can be exported

FUNCTIONS

new

     my $user = Debbugs::User->new('[email protected]',$lock);

Reads the user file associated with '[email protected]' and returns a Debbugs::User object.

OBSOLETE FUNCTIONS

read_usertags

     read_usertags($usertags,$email)

write_usertags

     write_usertags($usertags,$email);

Gets a lock on the usertags, applies the usertags passed, and writes them out.

PRIVATE FUNCTIONS

_file_from_email

     my $filename = _file_from_email($email)

Turns an email into the filename where the usertag can be located.

_read_stanza

     my @stanza = _read_stanza($fh);

Reads a single stanza from a filehandle and returns it

_wrap_to_length

     _wrap_to_length

Wraps a line to a specific length by splitting at commas